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PREFACE 


This manual describes how to use the iAPX 86,88 Family utilities: 

• LINK86 

• CREF86 

• LIB86 

• LOC86 

• OH86 


These products run on 8086- and 8088-based systems. They are used by program- 
mers developing programs with ASM86, ASM89, PL/M-86, PASCAL-86, 
FORTRAN-86, or any other language translator that produces object code compat- 
ible with the iAPX 86,88 Family of processors. The iAPX 86,88 Family of pro- 
cessors inlcudes 8086, 8088, 8087, and 8089 processor chips. Because the 8086 is the 
first member of this family, this manual uses 8086 generically to represent the entire 
family. 


This manual presumes familiarity with the conventions of the operating system 
under which the iAPX 86,88 utilities are being executed. It also presumes familiarity 
with the basic requirements of individual languages and translators. 


This manual is divided into the following chapters: 

• Chapter 1, Introduction: a summary of the relationship among the utilities and 
basic concepts governing their use 

• Chapter 2, LINK86: how to invoke, use the controls for, and read the printed 
listing from LINK86 

• Chapter 3, CREF86: how to invoke, use the controls for, and read the output 
listing from CREF86 

• Chapter 4, LIB86: how to invoke and use the commands for LIB86 

• Chapter 5, LOC86: how to invoke, use the controls for, and read the printed 
listing from LOC86 

• Chapter 6, OH86: how to invoke OH86 


This manual also contains several appendixes, meant for quick access to the follow- 
ing information: 

• iAPX 86,88 absolute object file format definitions (Appendix A) 

• Hexadecimal-decimal conversion information (Appendix B) 

• The effect of available memory on the performance of LINK86, CREF86, 
LIB86, and LOC86 (Appendix C) 

• Summaries of iAPX 86,88 Family utility controls and error messages: 

• LINK86 (Appendix D) 

• CREF86 (Appendix E) 

• LIB86 (Appendix F) 

• LOC86 (Appendix G) 

• OH86 (Appendix H) 


V 



NOTE 


The following appendixes address issues dependent on specific 
operating systems, such as operating environments, related 
publications, and examples. These appendixes contain foldout 
pages, designed to be opened out to your right and used in conjunc- 
tion with general instructions provided in the chapters and other 
appendixes. On these foldout pages you will find sample invoca- 
tions for the iAPX 86,88 Family utility controls and commands. 

• Additional information for Series III users (Appendix I) 

• Additional information for iRMX 86 users (Appendix J) 

• Additional information for Series IV users (Appendix K) 

Once you have gained sufficient familiarity with the basic principles of iAPX 86,88 

Family utilities operation, you will find the following publication convenient for 

quick syntax reference: 

• iAPX 86, 88 Family Utilities Pocket Reference, order number 1 2 1 669 

Before reading this manual, ensure that you are familiar with the following terms 

and conventions. 


Notational Conventions 

punctuation other than the following must be entered if required by the 

control syntax. 

•C > indicates that one and only one of the syntactic items 

contained within the braces is required. 

[ ] indicates that the syntactic item or items contained within the 

brackets are optional. 

indicates that the preceding syntactic item may be repeated an 
indefinite number of times. (The ellipsis is often used within 
brackets and with a comma “[,...]” to indicate that preceding 
item may be repeated, but each repetition must be separated 
by a comma.) 

I separates various options within the brackets [ ] or braces 

{.>. 

UPPERCASE indicates that these characters must be entered exactly as 

shown. 

italic indicates a meta symbol that may be replaced with an item 

that fulfills the rules for that symbol. The actual symbol may 
be any of the following: 

pathname is a valid designation foT a file; in its entirety, it consists of a 

directory-name and a filename. 

directory-name is that portion of a pathname that acts as a file locator by 
identifying the device and/or directory containing the 
filename . 

filename is a valid name for the part of a pathname that names a file. 
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minimum-size 

maximum-size 

paragraph 

offset 

address 

segment name 
moduie name 
ciass name 
group name 
overiay name 
pubiic symboi 
variable name 


Iblackl 


system-id 


pathnamel , 
pathname2, ... 

Vx.y 


are numbers and must follow Intel standards for number 
representation (see PL/M-86 or ASM86). Use the H suffix for 
hexadecimal, B suffix for binary, O or Q suffix for octal and 
D or nothing for decimal. 


are defined by the 8086 object file formats described in 
Appendix A. They may be up to forty characters 
long and may contain- any of the following characters in any 
order: 

A, B, C, D, E, F, G, H, 1, J, K, L, M, N, O, P, Q, R, S, T, U, V, 
W, X, Y, Z, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, ?, ., _, 

Black background is used in examples to indicate the user’s 
entries. 

is a generic label placed on sample listings where an operating 
system-dependent name would actually be printed. 

are generic labels placed on sample listings where one or more 
user-specified pathnames would actually be printed. 

is a generic label placed on sample listings where the version 
number of the product that produced the listing would 
actually be printed. 
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CHAPTER 1 
INTRODUCTION 


Program Development 

Program development is a proeess of varying complexity. The complexity depends 
on the language used to develop code, the complexity of the end product, and the 
tools chosen. 

Figure 1-1 shows the development process and the tools available for development 
of an iAPX86,88 Family-based product. 

The tools described in this manual are: 

• LINK86, which is a linkage and binding tool 

• CREF86, which provides a cross-reference of information on symbols in several 
modules 

• LIB86, which is the librarian function for 8086 object modules 

• LOC86, which is the relocation tool 

• OH86, which converts 8086 absolute object information to the hexadecimal 
format 


I I 



Figure 1-1 . The iAPX86,88 Family Development Process 


121616-1 
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Introduction 


iAPX 86,88 Family Utilities 


Overview of the Utilities 

ASM86, ASM89, PL/M-86, PASCAL-86, FORTRAN-86, and other translators as 
well as LINK86 and LOC86 produce 8086 object modules. The language translators 
produce 8086 relocatable object modules that must usually be processed by utilities 
before execution. (Under certain circumstances the translators can produce absolute 
object modules, but this is rare and does not contribute to modular design.) LINK86 
combines 8086 object modules, and LOC86 converts relocatable object modules into 
absolute object modules. OH86 converts 8086 absolute object modules to 8086 hexa- 
decimal format. 

LINK86 combines a list of 8086 object modules into a single object module and 
attempts to match all external symbol declarations with their public symbol defini- 
tions in library modules. (LIB86 is the utility used to create and maintain program 
libraries.) The output of LINK86 is a relocatable object module. However, when 
specified in the controls, LINK86 produces a load-time-locatable (LTL) object 
module; an LTL module can be executed on an 8086-based system. (See the descrip- 
tion of LTL modules later in this chapter.) Whether the LINK86 output is an LTL or 
a relocatable object module, it can serve as input to LOC86. 

CREF86 provides a means for producing a cross-reference listing of public and 
external symbols in multiple 8086 object modules. The object modules may include 
library modules. The output produced by CREF86 should help the programmer to 
identify how symbols will be resolved by LINK86, given the same input files. 


LOC86 converts relocatable (or LTL) object modules to absolute object modules. 
Absolute object modules contain references that require the module segments to be 
placed at particular places in 8086 memory. 


The sequence in which the segments in the input modules are combined and absolute 
addresses assigned to segments is determined by the controls supplied and the order 
in which the modules are listed in the LINK86 and LOC86 invocations. 


External References and Public Symbols 

An address field that refers to a location in a different object module is called an 
external reference. An external reference differs from a relative address because the 
translator that generates the modules knows nothing about the location of the 
referenced symbol. You must declare these references as external when coding a pro- 
gram. This tells the translator, and subsequently the relocation and linkage (R&L) 
utilities, that the target of the reference is in a different module. 

A module that contains external references is called an unsatisfied module. To 
satisfy the module, a module with a public symbol that matches the external symbol 
must be found. Associated with a public symbol in a module is an address that 
allows other modules, with the appropriate external reference, to reference the 
module with the public symbol. You must define these symbols as public when 
coding the program. This tells the source translator and the R&L utilities that other 
modules can reference the symbol. 

If there are external references uuat are not satisfied by public symbols, warning 
messages are issued and the resulting module remains unsatisfied. 
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Use of Libraries 


Libraries aid in the job of building programs. The library manager program, LIB86, 
creates and maintains files containing object modules. 


LINK86 and CRE;F86 treat library files in a special manner. If you specify a library 
file in the input to these utilities, they search the library for modules that satisfy 
unresolved external references in the input modules already read. This means that 
libraries should be specified after the input modules that contain external references. 
If a module included from the library has an external reference, the library is 
searched again to try to satisfy the reference. This process continues until all external 
references have been the subject of a search of all public symbols in the library 
modules. 


When LINK86 and CREF86 search a library, they normally include only library 
modules that satisfy external references in the output. If no external references are 
satisfied by a library, no modules from the library are included in the LINK86 out- 
put module or the CREF86 output listing. However, LINK86 and CREF86 provide 
the means to unconditionally include a library module even if there is no external 
reference to it. Figure 1-2 shows LINK86 handling of a library file. 


INPUTS 


MOD A 
MOD B 
MOD C 
MOD D 
MOD E 
MOD F 
MOD G 
MOD H 
MOD I 
MOD J 
MOD K 


MODI 



Figure 1-2. Library Linkage by LINK86 1216 I 6-2 
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Relative Addressing 

The relative addresses of instructions and data in program modules are assigned by 
the source translator. The addresses are relative to the beginning of the segment in 
which they reside. The relative address is actually the number of bytes from the 
beginning of the segment. 

After LINK86 combines all the input segments, LOC86 can be used to assign 
absolute memory addresses to all relative addresses. The resulting output module 
can only be executed when its segments are loaded at the absolute addresses assigned 
by the command. If LINK86 is used to create a bound object module, LOC86 is not 
needed to execute the program. 


The LINK86/LOC86 Process 

Although controls are not required for LINK86 and LOC86 execution, the com- 
mands invoking them may contain controls that affect their output. The controls 
make it possible to change the defaults for module combination, address assign- 
ment, and output information. 

The inputs are object modules in disk files. The input modules can contain relative 
addresses, absolute addresses, external references, and public symbols. The input 
modules must be in the 8086 object module format such as is generated by 8086 
translators and LINK86 and LOC86 themselves. 

LINK86 combines segments from the input modules, and for LTL object modules 
LINK86 orders segments in groups and assigns offsets. LOC86 orders the segments 
and assigns absolute addresses according to the controls specified with the command 
and/or the default algorithms. Both commands output the module when processing 
is completed along with any error messages and diagnostic information. Figure 1-3 
shows the LINK86/LOC86 process. 



Figure 1-3. The LINK86/LOC86 Process 121616-3 
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An 8086 Overview 

To use the R&L commands you must have an understanding of the following 

concepts: 

• Addresses, given as offsets into segments, which must be translated into 
absolute memory addresses, or base offsets 

• Segment definitions, which identify contiguous pieces of information, usually 
code or data 

• Class definitions, which identify segments that share common attributes and 
should be kept together 

• Group definitions, which identify segments that must be kept within a 64K byte 
range of memory 

• Overlay definitions, which identify modules that will be loaded in memory at 
different times during execution. 

• Load-time-locatable object modules 


Memory 

The 8086 can address up to a maximum of a megabyte of memory. In decimal a 
megabyte is 1,048,576 bytes. Memory addresses are always shown in hexadecimal. A 
megabyte of memory has the addresses: OH through OFFFFFH. 

Not all 8086-based systems will have a full megabyte of memory. Many systems will 
have gaps in the memory that is available. The different portions of memory will 
probably be implemented with different types of memory chips. The system monitor 
or supervisor is usually stored in ROM or PROM chips. Because it is not modified 
by execution it can be a permanent part of the system. This prevents the need to load 
it each time the system is turned on. The data that is referenced often is kept in high- 
speed RAM because it is modified frequently. It may be practical to keep data that is 
referenced less often in slower-speed memory. The size and composition of a 
system’s memory is totally dependent on the application the system serves. 

Linkage and relocation is designed to handle the linking and locating of your pro- 
gram, no matter how your 8086-based system memory is implemented. It provides 
very flexible segment placement within any given memory configuration. 


8086 Addressing Techniques 

The 8086 addresses memory with a 20-bit address that is constructed from a segment 
address and a 16-bit offset from that segment address. This means that with a single 
segment address, 64K bytes of memory is directly addressable by changing only the 
offset. 

A hardware segment address is a 20-bit address. But the segment address is con- 
strained such that the segment is placed on a boundary that is a multiple of 16 (lOH). 
The segment address can be set to any hexadecimal address ending in 0: 

OH 
01 OH 
020H 


OFFFFOH 
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Because the low four bits of the 20-bit segment address are always zero, the segment 
address can be represented with only 16 bits. 

The segment address is kept in one of four 16-bit segment registers. Because there 
are four segment registers, the 8086 can, at any moment, access 256K (4 x 64K) bytes 
of memory. The full megabyte of memory is accessed by changing the values in the 
segment registers. Figure 1-4 shows the 8086 addressing concept. 


SEGMENT 

REGISTER OFFSET 

I 1 2 3 4 H ] I 8 00 3H ] 


1 2 3 4 OH 
V 800 3H 


EFFECTIVE 20 BIT ADDRESS 


64K BYTES CAN BE 
ADDRESSED BY 
CHANGING THE 
OFFSET ONLY 


MEMORY 


64K BYTES 


FFFFFH 


OH 


Figure 1-4. 8086 Addressing 


639-4 


Segments 

Programs comprise pieces called segments, which are the fundamental units of 
linkage and relocation. The basic divisions have functional purposes related to the 
hardware configuration of memory. The portions of programs that are to be kept in 
ROM or PROM can be put in separate segments from the portions that will be kept 
in RAM. 

The 8086 Assembler allows the programmer to name the segments of the program 
being developed. The PL/M-86 compiler may generate predefined names for 
segments. 

A segment is a contiguous area of memory that is defined at translation time 
(assemble or compile). When defined, a segment does not necessarily have a fixed 
address or size. A fixed address is assigned to a segment during the locate function. 
The size can be changed by combining segments and by a control that specifies a 
specific size. Some translations may produce absolute object information, with 
absolute addresses and a specific segment size. 
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LINK86 combines all segments with the same complete (segment, class and overlay) 
name and combination type (memory, stack, etc.) from all input modules. The 
ordering of segments is done on the basis of these combined segments. The manner 
in which segments are combined depends on the alignment of the segments (which is 
described in the next topic) and a combining attribute associated with the segment. 

When we refer to combining segments, we are talking about how the segments will 
be loaded in memory, not how they will be stored in the output module. The 
segments in the LOC86 output module contain addresses that determine where they 
will be loaded in memory. The segments reside in the output module in the same 
order as they were in the input modules. Figure 1-5 shows the physical relationships 
between the input modules, output module, and loaded program. 


INPUT 

MODULES 


SEG A 


SEG B 


SEG C 


SEG D 


SEG E 


SEG F 


OUTPUT 
MODULE 
ON DISKETTE 


SEG A 


SEG B 


SEG C 


SEG D 


SEG E 


SEG F 


OUTPUT MODULE 
LOADED IN 
MEMORY 



Figure 1-5. Segment Physical Relationships 639-5 


Segment Alignment 

A segment ean have one (and in the case of the inpage attribute, two) of five align- 
ment attributes: 

• Byte, which means a segment can be located at any address 

• Word, which means a segment can be located only at an address that is a 
multiple of two, starting from address OFl 

• Paragraph, which means a segment can be located only at an address that is a 
multiple of 16, starting from address 0 

• Page, which means a segment can be located only at an address that is a multiple 
of 256, starting from address 0 

• Inpage, which means a segment can be located at whichever of the preceding 
attributes apply, plus must be located so that it does not cross a page boundary 

Figure 1-6 shows the segment alignment boundaries. 

Any alignment attribute except byte can result in a gap between combined segments. 

For example, when two page-aligned segments are combined, there will always be a 

gap, unless the first happens to be an exact multiple of 256 bytes in length. 
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PAGE = 256 BYTES 


Figure 1-6. Segment Alignment Boundaries eag e 


Segment Combining 

Segments containing data and code are combined end to end. There may be a gap 
between the segments if the alignment characteristics require it. The relative 
addresses in the segments are adjusted for the new longer segment. 

There are two special cases of segment combination: stack segments and memory 
segments. Such translators as PL/M-86 define these segments with the names 
STACK and MEMORY. With ASM86 you must define them by adding the STACK 
or MEMORY parameter to the SEGMENT directive. 

When stack segments are combined, they are overlaid but their lengths are added 
together. 

When memory segments are combined, they are overlaid with their low addresses at 
a common address. The length of the combined memory segment is the length of the 
largest segment that was combined. No relative address adjusting is necessary. Nor- 
mally the memory segment is located above (at a higher memory address) the rest of 
the program segments if no controls are used to override this. 

To make sure that stack segments are combined correctly, you should always give 
them the same segment name in each module. The same is true of memory segments. 
If you are going to link assembly language routines to PL/M-86 routines you should 
give them the names STACK and MEMORY to be compatible with PL/M-86. 


Segment Locating 

Segments are located in the order in which they are encountered in the input 
modules. If classes (described in the next section) are defined, the segments from a 
class are located together. The locating algorithm can be changed by using LOC86 
locating controls. 
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One variation to the sequential locating of segments is how the MEMORY segment 
is located. When the first segment with the memory attribute is encountered, it is 
placed last in the list of segments. This means that after all other segments are 
located, the MEMORY segment will be assigned the highest address in the output 
module. 


NOTE 

The MEMOFLY segment may not get located at the top of the module if its 
name or class name appears in any LOC86 control (other than SEGSIZE) or 
it has the absolute attribute. 


Classes 

A class is a collection of segments. When segments are defined in assembly 
language, a class name can be specified. The segments generated by such translators 
as PL/M-86 are generated with predefined class names. Any number of segments 
can be given the same class name. Class names can extend beyond module bound- 
aries; the same class name can be used in different modules that are to be combined. 

The primary purpose of classes is to collect together (in an arbitrary order) segments 
that share a common attribute and to manipulate this collection at locate-time by 
specifying only the class name. 

All segments with the same class name are located together in the memory address 
space of the output module. (You can override class collection by specifying the 
location of segments with the LOC86 ORDER control or LOC86 ADDRESSES 
control.) 

Classes give you a second means of collecting like segments in the output module. 
The first is giving segments the same name. If you are developing several modules 
that are to be combined, you may want to give the segment containing executable 
code the name CODE in each module. If there are several differently named 
segments within a module that contain executable code, you may want to give these 
segments the class name of CODE that causes them to be located together but not 
combined. (The same name can be used for segments and classes.) 


Groups 

A group is also a collection of segments. Groups define addressing range limitations 
in 8086 object modules. A group specifies a collection of segments that must be 
located within a 64K byte range. This means that the entire group of segments can be 
addressed with offsets from a single segment register. Or, to put it another way, the 
segment register need not be changed when addressing any segment in a group. This 
permits efficient addressing within the module. 

Group addressing always begins at an address that is a multiple of 16 (i.e., a 
paragraph boundary). R&L does not manipulate segments of a group to make sure 
they fall within a 64K byte range. However, if they do not fit in the range, a warning 
message is issued. 

The segments included in a group do not have to be contiguous in the output 
module. The only requirement is that all the segments defined in the group must 
totally fall within 64K bytes of the beginning address of the group. 
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Overlays 

Sometimes your 8086 program is too large to fit into the memory available on the 
system. Overlays permit programs to be larger than the available memory. 

Typically, an overlay is composed of code and data that is executed in one phase of a 
program’s execution, but not used at any other time. Once executed the memory 
used by this code can be overwritten with code and data used in an other phase. 
Sections of code that occupy the same part of memory at different times during 
execution are called overlays. 

Part of an overlaid program is always resident in memory; it usually comprises the 
main program module, frequently used routines, and the overlay loader. This part 
of the program is called the root. Figure 1-7 illustrates the memory configuration of 
one program that uses overlays. 



Figure 1 - 7 . Memory Configuration of Program with Overlays 639-7 


Position-independent Code and Load-Time- 
Locatable Code 

An LTL (load-time-locatable) program can be loaded anywhere in memory (assum- 
ing alignment attributes are honored). Code and data addresses are assigned by the 
system loader. References to segment bases (segment registers) are permitted. The 
loader, when it determines where to locate each segment, must resolve these 
references to the segment bases. Before executing the LTL program, the loader must 
also initialize the segment registers. 

A PIC (position-independent-code) program is an LTL program, but it contains no 
references to segment bases. To execute these programs the loader need only place 
the program in memory (recognizing alignment attributes) and initialize the segment 
registers and go. No fixup of segment bases is required. 


1-10 



CHAPTER 2 
LINK86 


LINK86 combines 8086 object modules and resolves references between 
independently translated modules. LINK86 takes a list of files and controls as input 
and produces two output files; a print file and an object file. 

Figure 2-1 illustrates the linkage process. The input files may be any object module 
(output from a translator, LINK86, LOC86 or an 8086 library file). The print file 
contains diagnostic information. The output object file is a bound load-time- 
locatable module or simply a relocatable module. 

This chapter provides details concerning the L1NK86 invocation, controls, and print 
file. For definition of file-naming and syntax notation conventions used in this 
chapter, refer to Notational Conventions following the Preface. For a summary of 
the LINK86 controls and information on error and warning messages that may be 
produced, refer to Appendix D. For details concerning symbol table space limita- 
tions, refer to Appendix C. 



Figure 2-1 . LINK86 Input and Output Files 121616-4 


LINK86 Invocation Line 

The general syntax for the invoeation line is: 

[directory-name] L I \iKd>6 input list[10 output fiie][controis] 

The input iist is one or more modules to be linked together into a single object 
module: 

pathname[imoduie name [, ...])][, ...] 

Unless a moduie name is specified, all modules in a pathname are included. If the 
pathname is a library file, any modules named in parentheses are included in the out- 
put fiie even if they do not contain public symbol definitions for external symbols 
declared elsewhere in the input list. 
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The input list may also contain the control PUBLICSONLY before selected 
pathnames. If you wish to include a file called PO or PUBLICSONLY, ensure that 
the filename is preceded by a directory-name in order to distinguish it from the con- 
trol or its abbreviation. 

The order of modules in the input list affects the order of segments in the output file. 

TO output file designates the file to receive the linked object module. If output file is 
not specified, then output is directed to a file that has the same pathname as the first 
element in the input list, but its extension is .LNK. If the first element in the list is a 
PUBLICSONLY control, then the first pathname in its argument is used for th 
default name. 

If the BIND control is specified, then the default name for the output file has no 
extension, and the object module can be executed without locating. 

The controls can be any subset of the controls specified in the next section. 


LINK86 Controls 


The controls are described in table 2-1 . 

Table 2-1 . Summary of LINK86 Controls 


Control 

Abbrev. 

Default 

ASS IG N ({ rar/atj/e (ad d re ss) }[,...] ) 

AS 

Not applicable 

ASSUMEROOT(pa^/?name) 

AR 

Not applicable 

BIND 

Bl 

NOBIND 

NOBIND 

NOBI 

COMMENTS 

CM 

COMMENTS 

NOCOMMENTS 

NOCM 

FASTLOAD 

FL 

NOFASTLOAD 

NOFASTLOAD 

NOFL 

INITCODE 

1C 

Not applicable 

LINES 

LI 

LINES 

NOLINES 

NOLI 

MAP 

MA 

MAP 

NOMAP 

NOMA 

MEM POOL{mln-size [ ,max-size ] ) 

MP 

Not applicable 

NAME(moc/ty/e name) 

NA 

Not applicable 

OBJECTCONTROLS( 

TUNES 1 NOLINES | 

COMMENTS 1 NOCOMMENTS 1 
SYMBOLS 1 NOSYMBOLS | 

PUBLICS [EXCEPKsymbol [,...])] | 
NOPUBLICS [EXCEPT(sym£io/ [,...])) | 
TYPE 1 NOTYPE | 

PURGE 1 NOPURGE}[,...]) 

OC 

Not applicable 

ORDER(-CgToup({segmenfl\c/ass[\ov'er/ay]]> 

[,...])> 

[,-]) 

OD 

Not applicable 
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Table 2-1 . Summary of LINK86 Controls (Cont’d.) 


Control 

Abbrev. 

Default 

OVERLAY[(over/ay)] 

ov 

NOOVERLAY 

NOOVERLAY 

NOOV 

PRINT[(pat/?name)] 

PR 

PRINT(oP/ecfft/e.MP1) 

NOPRINT 

NOPR 

PRINTCONTROLS( 

{LINES 1 NOLINES | 

COMMENTS 1 NOCOMMENTS | 
SYMBOLS 1 NOSYMBOLS | 
PUBLICS[EXCEPT(syra/50/[,...])] 1 
NOPUBLICS [EXCEPT(symtio/ [,...])] | 
TYPE 1 NOTYPE | 

PURGE 1 NOPURGE>[,...]) 

PC 

Not applicable 

PUBLICS [EXCEPT{symtio/ [,...])] 

PL [EC] 

PUBLICS 

NOPUBLICS [EXCEPT{sym6o/[,...])] 

NOPL[EC] 

PUBLICSONLY(paf/7name[,...]) 

PO 

Not applicable 

PURGE 

PU 

NOPURGE 

NOPURGE 

NOPU 

RENAMEGROUPS({group TO group }[,...]) 

RG 

Not applicable 

SEGSIZE( {segmeriflVc/asslNoi^er/ay]] 
(min-size[,[max-size]])y [,...]) 

SS 

Not applicable 

SYMBOLS 

SB 

SYMBOLS 

NOSYMBOLS 

NOSB 

SYMBOLCOLUMNS({1 | 2 | 3 | 4>) 

SC 

SYMBOLCOLUMNS(2) 

TYPE 

TY 

TYPE 

NOTYPE 

NOTY 


If you specify a control more than once in a single invocation line, only the last ver- 
sion entered counts. For example, if you enter NOMAP on the invocation line and 
then later decide you want a link map, you can specify MAP. The ASSIGN control, 
however, is an exception to this general rule. 

The following controls are effective only when the BIND control is specified: 

FASTLOAD 

MEMPOOL 

ORDER 

PRINTCONTROLS 

SEGSIZE 

SYMBOLCOLUMNS 

The following control is effective only when the BIND control is NOT specified: 
INITCODE 

The following control is effective only when the OVERLAY control is specified: 
ASSUMEROOT 

At the end of this document you will find operating system-specific examples of the 
L1NK86 controls. Fold out the pages containing the examples relevant to your 
operating environment and use them in conjunction with the syntax conventions 
provided in this chapter. 
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Syntax 

A S S I G N ( { variable-name ( address )}[,...]) 


Abbreviation 

AS 


Default 

Not applicable 


Definition 

ASSIGN makes it possible to define absolute addresses for symbols at LINK time. 
The absolute address associated with the variable-name is specified in address, 
which should be an absolute 20-bit memory address that conforms to PL/M-86 
notation. The variable-name is internally defined as a PUBLIC symbol. 


Notes 

• This control is particularly useful for memory-mapped I/O. 

• If the variable-name has a matching public definition in another module, the 
public definition in that module is flagged as as duplicate. Whenever a reference 
to the variable-name occurs, the variable defined in the ASSIGN control 
governs. 

• If multiple ASSIGN specifications are provided in one LINK86 invocation, all 
will be effective (not only the final entry). 
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ASSUMEROOT 


Syntax 

ASSUMEROOT (pathname ) 


Abbreviation 

AR 

Default 

Not applicable 


Definition 

ASSUMEROOT suppresses the inclusion of any library module(s) in an overlay if 
the library moclule(s) have already been included in a root file identified by 
pathname. When this control is used, the root file is scanned, and all external, 
undefined symbols in the overlay modules which have a matching definition in the 
root file are marked “temporarily resolved.” This marking means that while a 
library search for the symbols will not be made, their status remains externally 
undefined until the overlays are linked with the root. 


Notes 

• This control should be used only in conjunction with the OVERLAY control 
and libraries. 

• This control will not eliminate common library modules from overlay to 
overlay. 

• This control may not be used when an input module already has an overlay 
record. 
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Syntax 

BIND 

NOBIND 

Abbreviation 

BI 

NOBI 


Default 

NOBIND 


Definition 

BIND combines the input modules into a load-time-locatable (LTL) module. An 
LTL module may be loaded and executed, and any logical reference to a segment or 
group base can be resolved at load time. The load-time-locatable output cannot be 
loaded by the ICE-86 loader or UPM. 


Notes 

• FASTLOAD, MEMPOOL, ORDER, SEGSIZE, and SYMBOLCOLUMNS 
have no effect when NOBIND is specified, 

• When NOBIND is in effect, [NOJLINES, [NO]SYMBOLS, [NO]PUBLICS, 
and [NOjPURGE affect only the output object module. 

• When BIND is specified, the default object file name has no extension. 
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COMMENTS/NOCOMMENTS 


Syntax 

COMMENTS 

NOCOMMENTS 

Abbreviation 

CM 

NOCM 


Default 

COMMENTS 


Definition 

COMMENTS allows object file comment records to remain in the output module. 
The NOCOMMENTS control removes all comment records except those designated 
as nonpurgable. 

Comment records are added to the object module for various reasons. All 
translators add a comment record, identifying the compiler or assembler that pro- 
duced it. 

Comment records are superfluous to the production of executable code and may be 
removed at any time during the development process. 


Notes 

• See PURGE, PRINTCONTROLS and OBJECTCONTROLS. 

• COMMENT records should not be removed when you submit an object file in a 
Software Problem Report. 

• NOCOMMENTS will decrease the size of the output object file. 
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Syntax 

FASTLOAD 

NOFASTLOAD 


Abbreviation 

FL 

NOFL 

Default 

NOFASTLOAD 


Definition 

FASTLOAD reduces program loading time by causing data record concatenation. 
The data records are concatenated to a maximum length of 64K. FASTLOAD also 
makes the object file compact by removing such information as local symbols, 
public records, comments, and type information (unless the object file contains 
unresolved external symbols). 


Notes 

• This control is effective only when BIND is specified. 

• Output produced with this control in effect may be incompatible with LINK86 
versions earlier than 2.0. 
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INITCODE 


Syntax 

INITCODE 

Abbreviation 

IC 


Default 

Not applicable 


Definition 

INITCODE causes LINK86 to create a new segment that contains code to initialize 
the segment registers. The equivalent assembly language code is shown below: 


STACKFRAME 

DW 

stack frame 

DATAFRAME 

DW 

data frame 

EXTRAFRAME 

DW 

CLI 

extra frame 


MOV 

SS, CSrSTACKFRAME 


MOV 

S P , stack offset 


MOV 

DS, CSrDATAFRAME 


MOV 

ES, CS:EXTRAFRAME 


JMP 

program start 


Notes 

• The initialization code segment is created only if a register intialization record 
for 8086 segment registers exists in the input. These register initialization 
records are automatically produced by 8086-based translators for main 
modules. 

• BIND and OVERLAY controls used in conjunction.with INITCODE will cause 
LINK86 to ignore the INITCODE control and issue a warning message. 

• INITCODE should be used to ensure compatibility with 8085-based LINK86, 
LOC86, and LIB86 products. 

• The name of the new segment, if created, is ??INITCODE. 
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Syntax 

LINES 

NOLINES 

Abbreviation 

LI 

NOLI 

Default 

LINES 


Definition 

LINES allows line number information to remain in the object file. ICE-86 and 
other debuggers use this information. The line number information is not needed to 
produce executable code. The NOLINES control removes this information from the 
output file. 


Notes 

• See PRINTCONTROLS and OBJECTCONTROLS. 

• See the PURGE control. 

• NOLINES will decrease the size of the output object file. 

• Unless BIND is in effect, LINES/NOLINES affects only the object module. 

• LINES has no effect on local symbols; the inclusion of local symbol records in 
the object file is controlled by SYMBOLS. 


2-10 



iAPX 86,88 Family Utilities 


MAP/NOMAP 


Syntax 

MAP 

NOMAP 

Abbreviation 

MA 

NOMA 


Default 

MAP 


Definition 

MAP produces a link map and inserts it in the PRINT file. The link map eontains 
information about the attributes of logical segments in the output module. This 
includes size, class, alignment attribute, address (if the segment is absolute) and 
overlay name (if the segment is a member of an overlay). 

NOMAP inhibits the production of the link map. 


Notes 

• MAP can be overridden by the NOPRINT control. 

• See the diseussion of the link map at the end of this ehapter. 
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Syntax 

MEMPOOL iminimum-size[ , maximum-size ] ) 


Abbreviation 

MP 

Default 

Not applicable. 


Definition 

MEMPOOL specifies the dynamic memory requirements of the program. This 

allows the loader to check free memory at load time, and prevent a run-time error. 

The minimum size is a 20-bit number. There are three ways of specifying this value: 

• + indicates that the number should be added to the current dynamic memory 
requirements. 

• — indicates that the number should be subtracted from the current dynamic 
memory requirements. 

• no sign indicates that the number should become the new minimum dynamic 
memory requirement. 

The maximum size is a 20-bit number. There are two ways of specifying this value: 

• + indicates that the number should be added to the current minimum dynamic 
memory requirement. 

• no sign indicates that the number should become the new maximum dynamic 
memory requirement. 


Notes 

• The minimum-size must be less than or equal to the maximum-size. 

• MEMPOOL has no effect unless the BIND control is also specified. 
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NAME 


Syntax 

N A M E ( module name ) 


Abbreviation 

NA 

Default 

The module name of the first element in the input list. 


Definition 

NAME assigns the specified module name to the output module. If NAME is not 
specified, then the output module will have the name of the first module in the input 
list. 


The module name may be up to 40 characters long. It may be composed of any of 
the following characters in any order: 


? (question mark), 
@ (commercial at), 
: (colon), 

. (period), 

(underscore), 

A, B, C, ..., Z or 
0, 1,2, ...,9. 


Lower-case letters may be used, but they are automatically converted to uppercase. 


Notes 

• NAME does not affect the output file’s name. Only the module name in the 
output module’s header record is changed. 
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Syntax 

OBJECTCONTROLS({LINES | NOLINES | 

COMMENTS 1 NOCOMMENTS | 
SYMBOLS I NOSYMBOLS 1 
PUBLICS [EXCEPT(sym^o/[,...])] | 
NO PUB Lies [EXCEPT (sym^o/[,. ..])]! 
TYPE 1 NOTYPE j 
PURGE I NOPURGE) [,...] 

) 


Abbreviation 

oc 


Default 

Controls apply to both the print file and the object file. 


Definition 

OBJECTCONTROLS causes the controls specified in its arguments to be applied to 
the object file only. Comment records, line number records, local and public symbol 
records, and symbol type records are selectively included or excluded from the 
object file. This will not affect the print file nor the information contained in it. 

Notes 

• Abbreviations for the controls within the parentheses may be given. 

• A control specified in both OBJECTCONTROLS and PRINTCONTROLS has 
the same effect as specifying it once outside of these controls. 
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ORDER 


Syntax 

0 R D E R ( {group name ( {segment name 

[\ class name[\overlay name]]} 


Abbreviation 

OD 

Default 

Segments are placed into object file in the same order in which they were 
encountered in the input list. 


Definition 

ORDER specifies a partial or complete order for the segments in one or more 
groups. 

The group name identifies the group whose segments are to be ordered. 

The segment name identifies the segments to be ordered. The \ class name and 
\ overlay name may be used to resolve conflicts with duplicate segment names. If 
\overlay name is specified, the \ class name is required. 


Notes 

• ORDER has no effect unless BIND is also specified. 

• If one of the segments specified is not contained in the designated group, an 
error message is generated. 

• See discussion of module combination at the end of the chapter for details of the 
default ordering. 
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Syntax 

0 V E R L A Y [ ( overlay name ) ] 
NOOVERLAY 


Abbreviation 

ov 

NOOV 

Default 

NOOVERLAY 


Definition 

OVERLAY specifies that all of the input modules shall be combined into a single 
overlay module. When the optional overlay name argument is specified, all 
segments contained within the overlay module have that name in addition to their 
segment names and class names. When overlay name is not specified, LINK86 uses 
the module name of the first module in the input list. 


Notes 

• Each overlay in a given program must be linked separately before they are all 
linked into a single object module. 

• The overlay specified in the argument rrmst be the same as the overlay name 
used when calling the operating system to load the overlay. 

• When linking root and overlay files, L1NK86 assumes the first file in the 
invocation line is the root. 

• The ASSUMEROOT control can be specified in conjunction with the 
OVERLAY control. 
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PRINT/NOPRINT 


Syntax 

PRU\1 [(pathname)] 
NOPRINT 


Abbreviation 

PR 

NOPR 


Default 

PRINT (object file . M P 1 ) 


Definition 

PRINT allows you to direct the link map and other diagnostic information to a 
particular file. If the PRINT control is not specified or if the control is given without 
an argument, the print file will have the same pathname as the output file except the 
extension will be .MPl . NOPRINT prevents the creation of this file. 


Notes 

• The discussion at the end of this chapter describes the contents of the print file. 

• MAP, SYMBOLCOLUMNS, LINES, SYMBOLS, PUBLICS and 
PRINTCONTROLS affect the contents of the print file. 
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Syntax 

PRINTCONTROLS(UINES | NOLINES | 

COMMENTS I NOCOMMENTS | 
SYMBOLS I NOSYMBOLS | 

PUBLICS [EXCEPUsymbol[,...])] \ 
NOPUBLICS [EXCEPT(sym/?o/[,...])]| 
TYPE I NOTYPE | 

PURGE I N0PUR6E} 

) 


Abbreviation 

PC 


Default 

Controls apply to both the print file and the object file. 


Definition 

PRINTCONTROLS causes the controls specified in its arguments to be applied to 
the print file only. Line number information, and local and public symbol informa- 
tion are selectively included or excluded from the print file. This will not affect the 
object file or the information contained in it. 


Notes 

• When a control is specified in both the PRINTCONTROLS and the 
OBJECTCONTROLS, it has the same effect as specifying it once outside of 
these controls. 

• Abbreviations to the parenthesized controls may be used. 

• Unless BIND is specified, PRINTCONTROLS and its arguments have no 
effect. 
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PUBLICS/NOPUBLICS 


Syntax 

PUBLICS [EXCi.PUpublic symbol [, ...])] 
NOPUBLICS [EXCEPT (public symbol [, ...])] 


Abbreviation 

PL [EC] 

NOPL [EC] 


Default 

PUBLICS 


Definition 

PUBLICS causes the public symbol records to be kept in the object file and the 
corresponding information to be placed in the print file. Public symbol records are 
needed to resolve external symbol definitions in other files. The EXCEPT sub- 
control allows you to modify the control. Public records are used by LINK86 to 
resolve external references. 


Notes 

® The scope of PUBLICS can be modified by PRINTCONTROLS and 
OBJECTCONTROLS. 

® Unless BIND is specified PUBLICS/NOPUBLICS affect only the object file. 

• NOPUBLICS will decrease the size of the output object file. 
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Syntax 

PUBLICS0NLY(paf/7name[,...]) 


Abbreviation 

PO 

Default 
Not applicable 


Definition 

PUBLICSONLY is an input list control. When used it must appear in the input list 
and not the control list. 

PUBLICSONLY indicates that only the absolute public symbol records of the argu- 
ment files will be used. The other records in the module will be ignored. This can be 
used to resolve external references to 8089 files and overlays when a multifile overlay 
system is desired. 


Notes 

• Although it is possible to create overlays using PUBLICSONLY, it is easier to 
use the OVERLAY control to create overlays. 
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PURGE/NOPURGE 


Syntax 

PURGE 

NOPURGE 


Abbreviation 

PU 

NOPU 


Default 

NOPURGE 


Definition 

PURGE in the control list is exactly the same as specifying NOLINES, 
NOSYMBOLS, NOCOMMENTS, NOPUBLICS, and NOTYPE. NOPURGE in 
the control list is the same as specifying LINES, SYMBOLS, COMMENTS, 
PUBLICS, and TYPE. 

PURGE removes all of the debug or public records from the object file and their 
information from the print file. It will produce the most compact object file 
possible. 

The records that would be included by NOPURGE are useful to debuggers, but 
otherwise they are unnecessary for producing executable code. 

Notes 

• PRINTCONTROLS and OBJECTCONTROLS can be used to modify the 
scope of PURGE. 

• Unless BIND is specified, PURGE affects only the output object file. 
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Syntax 

RENAMEGROUPS ({group name TO group name} [,...]) 


Abbreviation 

RG 

Default 

All groups keep the name they already have. 

Definition 

RENAMEGROUPS allows you to change the group names assigned by the 
translator. The first group name must be an existing group in one of the modules in 
the input list. 


Notes 

None 
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SEGSIZE 


Syntax 

S EG S I Z E ( {segment name[\class name[\overlay name]] 

(minimum size[, [maximum size]] ) > 

Abbreviation 

SS 

Default 

Not applicable 

Definition 

SEGSIZE allows you to specify the minimum memory space needed for any seg- 
ment. If you specify the maximum size for a segment, that segment must either not 
be a member of any group or be the last segment in the group. 

The segment name identifies the segment whose size is to be changed. 

The minimum size is a 16-bit number. There are three ways of specifying this value: 

• + indicates that the number should be added to the current segment length. 

• — indicates that the number should be subtracted from the current segment 
length. 

• no sign indicates that the number should become the new segment length. 

The maximum size is a 16-bit number. There are two ways of specifying this value: 

• + indicates that the number should be added to the minimum segment length. 

• no sign indicates that the number should become the new maximum segment 
length. 

Notes 

• The maximum segment size must always be greater than or equal to the 
minimum segment size. 

• Segment lengths are initially assigned by the translator. 

• Unless BIND is also specified SEGSIZE has no effect. 
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Syntax 

SYMBOLS 

NOSYMBOLS 


Abbreviation 

SB 

NOSB 

Default 

SYMBOLS 


Definition 

SYMBOLS specifies that all local symbol records shall be included in the object file. 
Local symbol records are used by debuggers. 


Notes 

• Unless BIND is also specified, SYMBOLS affects only the output object file. 

• NOSYMBOLS will decrease the size of the output object file. 

• SYMBOLS has no effect on line numbers; the inclusion of line numbers in the 
object file is controlled by the LINES control. 
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SYMBOLCOLUMNS 


Syntax 

SYMBOLCOLUMNS ({1 | 2 | 3 | 4>) 

Abbreviation 

SC 

Default 

SYMB0LC0LUMNS(2) 


Definition 

SYMBOLCOLUMNS indicates the number of columns to be used when producing 
the symbol table for the object module. Two columns fit on a 78-character line; four 
columns fit on a single 128-character line printer line. 


Notes 

® SYMBOLCOLUMNS has no effect unless BIND is also specified. 
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Syntax 

TYPE 

NOTYPE 


Abbreviation 

TY 

NOTY 

Default 

TYPE 


Definition 

TYPE specifies that type checking is to be performed on the object file. Symbol type 
records produced by the translator are used by LINK86 to perform type checking on 
modules. Symbol type records should be kept in the file if it may be relinked with 
another file. 


Notes 

• NOTYPE will decrease the size of the ouput object file without affecting 
run-time operation. 
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LINK86’s Print File 

The print file is always created unless you specify NOPRINT. The optional argu- 
ment to PRINT designates the name of the print file. The default print file is the 
object file with the extension .MPl . 

The print file may contain as many as five parts: 

1 . A header (always in the print file) 

2. A link map (requires MAP) 

3. A group map (requires BIND) 

4. A symbol table (requires BIND and PUBLICS, LINES, or SYMBOLS) 

5 . An error message list (always included when they occur) 

The Header 

The header is self-explanatory; it identifies the 8086 linker by version number and 
gives the important details about the input and output files used during this execu- 
tion. Figure 2-2 shows an example of LINK86’s print file header. 


system-id b086 LINKER, Vx.y 

INPUT FILES: \ pathname1,pathname2 

OUTPUT FILE: \ pathnames 

CONTROLS SPECIFIED IN INVOCATION COMMAND; 
BIND 

DATE: MM/DD/YY TIME: HH:MM:SS 



Figure 2-2. LINK86 Print File Header 


The Link Map 


The link map supplies useful information about segments in the object file — order, 
size, alignment attribute, and segment, class, and overlay names. Figure 2-3 shows 
LINK86’s link map. 


LINK MAP OF MODULE HOOT 


LOGICAL 

SEGMENTS INCLUDED: 


LENGTH 

ADDRESS ALIGN 

SEGMENT 

CLASS 

09B6H 


CODE 

CODE 

0016H 

- W 

CONST 

CONST 

0B38H 


DATA 

DATA 

041I2H 

- h 

STACK 

STACK 

OOOOh 


MEMORi' 

MEMONY 

OOOOH 

- G 

?7SEG 



INPUT MODULES INCLUDED: 
pathnameUROOT) 


Figure 2-3. L1NK86 Link Map 
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The map consists of three parts: 

• Segment map 

• Input module list 

• Unresolved symbol list 

The segment map describes all of the segments included in the object file. Each seg- 
ment description includes five entries: length, the address (if the segment is 
absolute), alignment attribute, segment name, class name and overlay name, if any. 

A segment may have any one of the following alignment attributes: 

A absolute 
B byte 
G paragraph 

M member of an LTL group 
P page 
W word 
R in-page 

In-page alignment means that the entire segment must be resident within a single 
256-byte page. The address of the first byte in any page has zeros in the first 2- 
hexadecimal digits (OOH, lOOH, 200H,...0FFr00H). 

The module list identifies the order of modules included in the output file. LINK86 
gives both the file containing the module and the module name for each entry in the 
list. 

The unresolved symbol list itemizes each external symbol whose public definition 
was not encountered. The module that references the unresolved symbol is also 
indicated. The printed message that appears under the heading UNRESOLVED 
EXTERNAL NAMES is as follows: 

• symbol name IN pathname (module name) 

• If ASSUMEROOT is specified, the message would read: 
symbol name (DEFINED IN ROOT- F I LE ,paf/7na/77e) 

• If PUBLICS/NOPUBLICS EXCEPT is specified, the message would read: 
symbolname IH LINK86 COMMAND LINE 

The Group Map 

LINK86 produces a group map when the BIND control is specified. Each group 
name and all segments contained in that group are listed. The offset from the group 
base for each segment appears to the right of the segment name. Figure 2-4 shows an 
example of the group map. 
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LINK86 


The Symbol Table 

LINK86 produces a symbol table only when the following conditions are true: 

1. BIND is specified 

2. PRINT and MAP controls are in effect. 

3. At least one of the following controls is in effect: PUBLICS, LINES, or 
SYMBOLS. 

Figure 2-5 shows LINK86’s symbol table with the SYMBOLCOLUMNS set at two 
(the default). The symbol table is shown in two parts: the top section contains the 
public symbol information; the lower section contains line and local symbol 
information. 


SYMBOL TABLE OF MODULE BOOT 


BASE 

OFFSET 

TYPE 

SYMBOL 

BASE 

OFFSET 

TYPE 

SYMBOL 

0(2) 

OIbbH 

PUB 

BINDCONTfiOL 

0(2) 

004CH 

PUB 

BNODEBASE 

0(2) 

0018H 

PUB 

BUFBASE 

0(2) 

0016H 

PUB 

BUFLEN 

0(2) 

004EH 

PUB 

CLASHNODEBASE 

0(2) 

0060H 

PUB 

COCONN 

0(2) 

01 5AH 

PUB 

COMMENTSCONTROL 

0(2) 

0171H 

PUB 

CURRENTOVERLAYNU 

-M 

DEFAULIPRTFILENA 

0(2) 

0173H 

PUB 

DEBUGTOGGLE 

0(2) 

00A7H 

PUB 

0(2) 

00b2H 

PUB 

EXCEPTION 

0(2) 

0048H 

PUB 

-ME 

FANODEBASE 

0(2) 

006EH 

PUB 

FBLOCKBASE 

0(2) 

006AH 

PUB 

FBLOCKLISTHEAD 

0(2) 

006CH 

PUB 

FBLOCKLISTTAIL 

0(2) 

013DH 

PUB 

FBLOCKSEQUENCENU 

-MBEH 

0(2) 

004AH 

PUB 

FBNODEBASE 

0(2) 

0046H 

PUB 

FDNODEBASE 

0(2) 

0044H 

PUB 

FENODEBASE 

0(2) 

0040H 

PUB 

FFNODEBASE 

0(2) 

0034H 

PUB 

FIRSTBNODEP 

0(2) 

0028H 

PUB 

FIRSTEXNODEP 

0(2) 

002CH 

PUB 

FIRSTGHNODEP 

0(2) 

00 1CH 

PUB 

FIRSTNMNODEP 

0(2) 

0030H 

PUB 

FIRSTOVNODEP 

0(2) 

0050H 

PUB 

FIRSTRENAMEBLOCK 

0(2) 

0020H 

PUB 

FIRSTSGNODEP 

0(2) 

0024H 

PUB 

FIRSTTDNODEP 

0(2) 

0038H 

PUB 

GRNODEBASE 

0(2) 

0B4CH 

PUB 

HIGHESTDATALOCAT 


-ION 



MODULE NAME = ROOT 


BASE 

OFFSET 

TYPE 

SYMBOL 

BASE 

OFFSET 

TYPE 

SYMBOL 

0(2) 

0F90H 

SYM 

MEMORY 

0(2) 

OOOOH 

SYM 

COPYRIGHT 

0(2) 

001 6h 

SYM 

BUFLEN 

0(2) 

0018H 

SYM 

BUFBASE 

0(1 ) 

00F7H 

SYM 

ERROR 

0(1) 

OOFEH 

SYM 

WARNING 

0(2) 

OOlAh 

SYM 

LASTNMNODEP 

0(2) 

001CH 

SYM 

FIRSTNMNODEP 

0(2) 

001 Eh 

SYM 

LASTSGNODEP 

0(2) 

0020H 

SYM 

FIRSTSGNODEP 

0(2) 

0022H 

SYM 

LASTTDNODEP 

0(2) 

0024H 

SYM 

FIRSTTDNODEP 

0(2) 

002bH 

SYM 

LASIEXNOOEP 

0(2) 

002OH 

SYM 

FIRSTEXNODEP 

0(2) 

002AH 

SYM 

LASTGRNODEP 

0(2) 

002CH 

SYM 

FIRSTGRNODEP 

0(2) 

002Eh 

SYM 

LASTOVNODEP 

0(2) 

0030H 

SYM 

FIRSTOVNODEP 

0(2) 

0032H 

SYM 

LASTBNODEP 

0(2) 

0034H 

SYM 

FIRSTBNODEP 

0(2) 

0036H 

SYM 

SGNODEBASE 

0(2) 

003BH 

SYM 

GRNODEBASE 

0(2) 

003AH 

SYM 

SYNODEBASE 

0(2) 

003CH 

SYM 

NMNODEBASE 

0(2) 

003EH 

SYM 

TDNODEBASE 

0(2) 

0040H 

SYM 

FFNODEBASE 

0(2) 

0042H 

SYM 

OVNODEBASE 

0(2) 

0044H 

SYM 

FENODEBASE 

0(2) 

0046H 

SYM 

FDNODEBASE 

0(2) 

0048H 

SYM 

FANODEBASE 

0(2) 

004AH 

SYM 

FBNODEBASE 

0(2) 

004CH 

SYM 

BNODEBASE 

0(2) 

004EH 

SYM 

CLASHNODEBASE 

0(2) 

0050H 

SYM 

FIRSTRENAMEBLOCK 

•P 



Figure 2-5. LINK86 Symbol Table 
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Figure 2-5. LINK86 Symbol Table (Cont’d.) 


BASE is usually a symbolic group or segment index. If the base is the stack, then 
STACK is used instead of the index. 

OFFSET is a four-digit hexadecimal number that is the offset of the symbol or line 
from BASE, or from the current BP for stack symbols. 

TYPE describes the kind of symbol it is. There are four possible entries in the TYPE 
column; 

BAS based on an other symbol’s value 
L I N line (not a symbol) 

PUB public symbol (alphabetized within each separate BASE) 

SYM local symbol 

SYMBOL refers to the name of the symbol or number of the line. If the 
SYMBOLCOLUMNS value is one, this field is 40 characters wide. Otherwise, this 
field is 16 characters wide. If the symbol name is longer than the width of the field, 
then the name is hyphenated and continued on the next line. 

If there are any references to segment bases in the input modules (if the output 
module is an LTL program), L1NK86 prints the following message at the bottom of 
figure 2-5. The message identifies all input modules containing such references. 
These references are to be resolved by the system loader or LOC86. 


Error Messages 

The warning messages are listed conseeutively as warning situations are 
encountered. They may appear before or after the link map. Errors always terminate 
processing — an error message will always be the last line in the print file. 

See the discussion of the interpretation of individual messages in Appendix C. 
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CREF86 scans 8086 object modules to provide a cross-reference among external and 
public symbols in multiple modules. CREF86 accepts a list of files and controls as 
input and produces one output file: a print file. 

Figure 3-1 illustrates the types of input accepted and output produced. The input 
modules may include one or more of the following 8086 object modules: 

• Unlinked modules from one or more translators 

• Library files or specific library modules 

• Linked modules 

The output file consists of information about files and modules, plus an 
alphabetically sorted list of external and public symbols. Information printed for 
each symbol includes the name of the module defining the symbol and the name(s) 
of the module(s) declaring the symbol as external. 

This chapter provides details concerning the CREF86 invocation, controls, and 
cross-reference listing. For definition of file-naming and syntax notation conven- 
tions used in this chapter, refer to Notational Conventions following the Preface. 
For a summary of the CREF86 controls and information on error and warning 
messages which may be produced, refer to Appendix E. For details concerning 
CREF86 symbol table space limitations, refer to Appendix C. 



Figure 3-1 , CREF86 Input and Output Files 


121616-5 





CREF86 


iAPX 86,88 Family Utilities 


CREF86 Invocation Line 


The general syntax for invocation is: 

[directory-name] C R E F 8 6 input iist[controls] 

The input list is one or more modules to be scanned for external-public cross- 
references: 

pathname[{ module name[, 

Unless a module name is specified, all modules in a pathname are included in the 
cross-reference listing produced. If the pathname is a library file, any modules 
named in parentheses are included in the cross-reference listing, even if they do not 
contain public symbol definitions for external symbols declared elsewhere in the 
input list. 

Either all or none of the pathnames may contain overlay records (produced by 
LINK86 with the OVERLAY control). If the input modules do contain overlay 
records, the first file named in the invocation is considered to be the root file; the 
rest are treated as overlays. 

The controls can be any subset of the controls described in the next section. 


CREF86 Controls 


The controls specify cross-reference listing attributes such as print file name, the 
title at the top of each listing page, and the am-ount of information printed on each 
page. The controls are described in table 3-1 . 


Table 3-1 . Summary of CREF86 Controls 


Control 

Abbrev. 

Default 

PAGELENGTH(mymher) 

PL 

PAGELENGTH(60) 

PAGEWlDTH(numher) 

PW 

PAGEWIDTH(120) 

PR\NT[(pathname)] 

PR 

PRmJ(first input file. CRf) 

J\JLE(character-string) 

TT 

Not applicable 


If there are multiple occurrences of any control in the invocation line, the rightmost 
occurrence governs. 

At the end of this document you will find operating system-specific examples of the 
CREF86 controls. Fold out the pages containing the examples relevant to your 
operating environment and use them in conjunction with the syntax conventions 
provided in this chapter. 
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PAGELENGTH 


Syntax 

PAGELENGTH inumber) 

Abbreviation 

PL 

Default 

PAGELENGTH(60) 

Definition 

PAGELENGTH specifies the number of lines to be printed on each page. The 
number must be a decimal value between 10 and 255, inclusive. 

Notes 

None 
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Syntax 

PAGEWIDTH(A7t;mt?er) 

Abbreviation 

PW 

Default 

PAGEWIDTH(120) 


Definition 

PAGEWIDTH specifies the maximum number of characters to be printed on a 
single line. The number must be a decimal value from 80 to 1 32, inclusive. 


Notes 

• PAGEWIDTH truncates the TITLE if TITLE is greater than the number of 
unused character locations on the title line. 

• If the specified PAGEWIDTH does not allow enough space to print the 
referring module name(s) on the same line as the defining module name, the 
referring module names(s) will be printed on separate lines. 
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PRINT 


Syntax 

PR I NT[(paf/7na/77e) ] 


Abbreviation 

PR 

Default 

P R I N T ( first input fiie . C R F ) 


Definition 

PRINT provides the ability to specify a pathname for the cross-reference listing. 
The pathname identifies the destination of the listing. If the PRINT control is not 
specified or if the control is given without an argument, the print file will have the 
same pathname as the first file in the input list, except the extension will be .CRT. 


Notes 

• If no PRINT control is specified, output goes to a default file. The name of the 
default file is the name of the first file in the invocation command with the 
extension .CRF. 

• If PRINT is specified with no pathname, output goes to the default file. 
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Syntax 

TITLE {character string) 


Abbreviation 

TT 

Default 

Not applicable 


Definition 

TITLE may be used to specify a heading having a character string of null to 80 
characters, inclusive. This heading appears on the first line of every page of the 
cross-reference listing. 


Notes 

• The TITLE string is truncated if the PAGEWIDTH control is not large enough 
to accommodate the entire string. 

• If the character string contains any characters defined by the operating system 
as special, the string must be delimited in accord with operating system conven- 
tions for special characters and string delimiters. 
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CREF86’s Print File 

The print file is a cross-reference listing of external and public symbols in the input 
modules. This listing consists of the following parts: 

• A header 

® Warnings (if any) 

• Module list 

• Cross-reference information 


Header 

Figure 3-2 illustrates the components printed in this part of the cross-reference 
listing: 

• A title line output by CREF86, usually consisting of a program identifier 
(CREF86), any user-defined TITLE, date of listing, and the page number 

• A line identifying the CREF86 environment (operating system and version 
number) 

• One or more lines summarizing the pathnames of input files 

• A line for identifying the print file pathname 

• One or more lines giving the controls specified at invocation, present only if 
controls were specified 


Warnings 

Figure 3-3 illustrates how warning messages appear on the cross-reference listing 
when CREF86 detects such conditions as mismatched types, modules not found, etc. 
Refer to Appendix E for information on CREF86 error and warning messages. 


CHEF06 EXAMPLb OF CROSS REFERENCE USING CREFbb 


system-id CREF 60 Vx.y 

INPUT FILES: pathnamel pathname2 pathnames pathname4 

pathname/ pathnames pathnames pathnamelO 

pathnamelS pathnameU pathnamelS pathnamelS 

OUTPUT FILE: pathnamelS 

CONTROLS SPECIFIED: PR(OUT) TKEXAMPLE OF CROSS REFERENCE USING CREF 66 ) PW(120) PL(60) 


pathnames 

pathnameU 

pathnamel/ 


pathnames 

pathnamelS 



Figure 3-3. Warning Messages on CREF86 Listing 
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Module List 

The module list, shown in figure 3-4, is a tabulated summary of all input files and 
corresponding modules included from these files. 

After the module list is printed, the rest of the page is skipped, so that the symbol 
cross-references begin on the next new page. 



MODULES INCLUDED: 

FILE NAME MODULE NAME(S) 

pathnamel CREF66 

pathname^ PARSE 

pathnames SI G NON 

pathname4 NEXTSTATE 

pathnames ERROR 

pathnames UTILITIES 

pathname/ MEMORYMANAGEMENT 

pathnames SCANMODULES 

pathnames PROCESSRECORDS 

pathnamelO SCANUTILITIES 

pathnamell LI ST OUTPUT 

pathnames LISTUTILITIES 

pathnamelS SYMbOLSORT 

pathnameU OBJMAN 

pathnamelS MISMATCH 

pathnamelS 


pathname17 

DQALLOCATE 

DQATTACH 

DOCHANGEEXTENSION 

DQCREATE 

DQDECODEEXCEPTION 

DQDETACH 

DQEXIT 

DQFREE 

DQGETARGUMENT 

DQGETSYSTEMID 


DQGETTIME 

DQOFEN 

DQREAD 

DQSEEK 

DC3WRITE 


SYSTEMSTACK 



Figure 3-4. Module List on CREF86 Listing 


Symbol Cross-Reference Information 

Figure 3-5 illustrates the format for listing data for all external and public symbols 
referenced in the Module List. 


The first column contains the names of the external and public symbols, in 
alphabetical order. 


The second column identifies the type of each symbol, as declared in the external or 
public reference. The following tabulation identifies the entries which may occur in 
this column: 

CREF86 Entry Symbol Type 

BYTE 8-bit unsigned 

WORD 16-bit unsigned 

DWORD 32-bit unsigned 

LWORD 64-bit unsigned 

INTEGER(n) n = 1, 2, 4, or 8 bytes 

REAL(n) n = 1, 2, 4, or8 bytes 

POINTER 
STRUCTURE 
ARRAY OF 

UNKNOWN null 

FILE 
LABEL 
PROCEDURE 
(NEAR, FAR) 

CONSTANT 

SELECTOR 

The symbol type that appears in the second column is that associated with the first 
occurrence of that symbol in the input list. 
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CREF86 EXAMPLE OF CROSS REFERENCE USING CREF86 


SYMBOL NAME 


SYMBOL TYPE 


DEFINING MODULE; REFERRING MODULE(S) 


ACCESS_PAGE UNKNOWN 

ALLOCATE UNKNOWN 

APPENDNODE PROCEDURE NEAR 

APPENDUDSMNODE PROCEDURE NEAR 

ARRAYBASE POINTER 

ATOI PROCEDURE WORD NEAR 

BTOX PROCEDURE WORD NEAR 

BUBBLESORTVARNAMES. . . . PROCEDURE NEAR 

BUMPLINECOUNT PROCEDURE NEAR 

CHECKHEADER PROCEDURE NEAR 

CHECKOVERLAY PROCEDURE NEAR 

CHECKVARTYPE PROCEDURE BYTE NEAR 

CMPNAMES PROCEDURE BYTE NEAR 

CMPSTRNGS PROCEDURE BYTE NEAR 

CNCTI WORD 

CNCTO WORD 

CONTROLIDCOORDINATE . . . WORD 

CONTROLOFFSETCOORDINATE . BYTE 

CONTROLSARESPECIFIED. , . BYTE 

CREATEOBJECT PROCEDURE WORD NEAR 

CURRENTOVLNUM BYTE 

CURRENI_PAGE UNKNOWN 

DEBUGTOGGLE BYTE 

DEBUGTOGGLE BYTE 

DQALLOCATE PROCEDURE WORD NEAR 

DQATTACH. PROCEDURE WORD NEAR 

DQCHANGEEXTENSION .... PROCEDURE NEAR 

DQCREATE. PROCEDURE WORD NEAR 

DQDECODEEXCEPTION .... PROCEDURE NEAR 

DQDETACH. . PROCEDURE NEAR 

DQEXIT PROCEDURE NEAR 

DQFREE PROCEDURE NEAR 

DQGETARGUMENT PROCEDURE BYTE NEAR 

DQGETSYSTEMID PROCEDURE NEAR 

DQGETTIME PROCEDURE NEAR 


OBJMAN 

OBJ MAN 

UTILITIES 

UTILITIES; 

SYMBOLSORT; 

UTILITIES; 

UTILITIES; 

SYMBOLSORT; 

LISTUTILITIES; 

SCANUTILITIES ; 

SCANUTILITIES; 

SCANUTILITIES; 

LISTUTILITIES; 

UTILITIES; 

UTILITIES; 

UTILITIES; 

PARSE; 

PARSE; 

PARSE; 

OBJMAN ; 

PROCESSRECORDS; 

OBJMAN 


PARSE; 

•‘••DUPLICATE D£CLARATION*»“ : MISMATCH 
DQALLOCATE; 

DQATTACH; 

DQCHANGEEXTENSION; 

DQCREATE; 

DQDECODEEXCEPTION ; 

DQDETACH: 

DQEXIT ; 

DQFREE; 

DQGETARGUMENT; 

DQGETSYSTEMID; 

DQGETTIME; 


PARSE SCANhODULES PROCESSRECORDS 

LISTOUTPUT 

PARSE 

LISTUTILITIES 

LISTOUTPUT 

LISTOUTPUT 

SCANMODULES 

SCANMODULES 

PROCESSRECORDS 

SYMBOLSORT 

NEXTSTATE SCANMODULES SCANUTILITIES 
MISMATCH 

SIGNON ERROR MISMATCH 

UTILITIES 

UTILITIES 

UTILITIES 

PARSE SCANMODULES PROCESSRECORDS 
SCANUTILITIES SYMBOLSORT 
SCANUTILITIES 


ERROR 


MEMORYMANAGEMENT SYMBOLSORT OBJMAN 

UTILITIES SCANUTILITIES 

PARSE 

UTILITIES 

ERROR 

SCANMODULES 

CREF86 ERROR 

LISTOUTPUT 

PARSE 

SIGNON 

LISTOUTPUT 


Figure 3-5. Symbol Cross-Reference Information 


The third column contains the following for each symbols listed: 

• The name of the module in which the symbol is defined public (defining 
module) 

• A semicolon (;), if there are external references to the symbol in any of the input 
modules 

• The name(s) of the modules(s) in which the symbol is declared external 
(referring module(s)) 

The third column is also used to flag unresolved and duplicate references. In the case 
of unresolved external references, the string ***UNRESOLVED*** appears before 
the semicolon. In the case of duplicate references, i.e., when a symbol has two or 
more public definitions, the first public declaration is considered legal, and the rest 
are flagged as duplicates. The string ***DUPLICATE DECLARATION*** 
appears, followed by a colon (:) and the name of the module containing the 
duplicate public declaration. 

If the input files contain overlays, CREF86 produces a symbol cross-reference that 
consolidates all the symbols from all overlay and root modules. The first file in the 
input list is considered to be the root file. CREF86 distinguishes between public 
symbols with the same name in different overlays and does not flag these symbols as 
duplicates. However, CREF86 does flag duplicate public declarations within any 
one root/overlay combination. 
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LIB86 


LIB86 allows you to create, modify, and examine library files. It is an interactive 
program. 

This chapter provides details concerning LIB86 invocation and commands. For 
definition of file-naming and syntax notation conventions used in this chapter, refer 
to Notational Conventions following the Preface. For a summary of the L1B86 com- 
mands and information on error and warning messages that may be produced, refer 
to Appendix F. For details concerning LIB86 symbol table space limitations, refer to 
Appendix C. 


L1B86 Invocation 


The general syntax for the invocation line is; 
[directory-name] L I B 8 6 [comment] 


LIB86 Commands 


Once LIB86 has begun execution, it displays an asterisk (*) and waits for a com- 
mand. Table 4-1 lists all of LIB86’s commands. 


Table 4-1. Summary of LIB86 Commands 


Command 

Abbrev. 

Description 

ADD ipathname[(module name [,...])]> 
[,...] TO pathname 

A 

Adds modules to a library 

CREATE pathname 

C 

Creates library files 

DELETE pathname(module name [,...]) 

D 

Deletes modules from a library file 

EXIT 

E 

Terminates session with LIB86 

LIST ipathname[(module name [,...])]> 

L 

Lists modules contained in a library 

[,...] [TO pathname] [PUBLICS] 

[P] 

file, and optionally lists all publics 


At the end of this document you will find operating system-specific examples of the 
LIB86 commands. Fold out the pa^es containing the examples relevant to your 
operating environment and use them in conjunction with the syntax conventions 
provided in this chapter. 
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Syntax 

ADD ipathname1[(module name[, ...])]}[, ...]10 pathname2 


Abbreviation 

A 


Definition 

ADD adds modules to a library file. 

The pathnamel can be an object file or a library file. 

The pathname2 is the destination library file. The library must exist before the ADD 
command is given; it may contain other modules. 

If pathnamel is an object file produced by a translator, LINK86, or LOC86, then all 
modules contained within the object file will be added to the designated library. 

If pathname2 is a library file, it may be specified with or without the module name 
list. If no module name list is specified, all modules contained in the source library 
will be added to the destination library. If the module name list is specified, then 
only the modules specified within the parentheses are added to the destination 
library. 
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CREATE 


Syntax 

CREATE pathname 

Abbreviation 

C 

Definition 

CREATE creates a library file with the specified pathname. 

Notes 

* If a file with the specified pathname already exists, the library will not be 
created and an error message will be provided. 
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Syntax 

DELETE pathname (.module name [,...]) 

Abbreviation 

D 

Definition 

DELETE removes modules from a library file. Modules can be deleted from only 
one library at a time. 

Notes 

None 
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EXIT 


Syntax 

EXIT 

Abbreviation 

E 


Definition 

EXIT terminates a session with LIB86 and returns control to the operating system. 


Notes 

• LIB86 disassembles libraries into an internal form. The library is not 
reconstituted until the EXIT command is processed. Therefore significant I/O 
will take place following an EXIT command. 
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Syntax 

LIST {pathname1[innodule name [, ...])]} [,...][T0 pathname2] 
[PUBLICS] 


Abbreviation 

L [P] 


Definition 

LIST prints the names of modules, and optionally the public symbols contained in 
those modules, to the specified output pathname. 

The pathnamel is the library whose modules are to be listed. 

The module name, if specified, identifies the modules to be listed. 

TO pathname2 identifies the device or file to receive the listing. If it is not specified, 
the listing is directed to the console output device. 

PUBLICS indicates that, in addition to the module names, all public symbols con- 
tained within the module will also be listed. PUBLICS may be abbreviated as ‘P’. 


Notes 

None 



CHAPTER 5 
LOC86 


LOC86 changes a relocatable 8086 object module into an absolute object module. 
As figure 5-1 illustrates, LOC86 takes a single 8086 object module as input and out- 
puts a located object file and, optionally, a print file. The print file output contains 
diagnostic information. The object file contains absolute object code. 

This chapter provides details concerning the LOC86 invocation, controls, and print 
file. For definition of file-naming and syntax notation conventions used in this 
chapter, refer to Notational Conventions following the Preface. For a summary of 
the LOC86 controls and information on error and warning messages that may be 
produced, refer to Appendix G. For details concerning LOC86 segment support 
capabilities, refer to Appendix C. 
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Figure 5-1 . LOC86 Input and Output Files 121616-6 


LOC86 Invocation Line 

The general syntax for the invocation line is: 

[directory-name] L 0 C 8 6 input file [T 0 object file] [controls] 

The input file is a file containing an object module to be located. It is usually, but 
not necessarily, the output from LINK86. 

TO object file specifies the file to receive the located object module. In most cases 
this is an executable file. If object file is not specified, then output will be directed to 
a file that has the same pathname as the input file, except it will have no extension. 

The controls may be any subset of the controls described in the next section. 


LOC86 Controls 

The controls are described in table 5-1 . 

If you specify the same control more than once in the same invocation line, only the 
last version entered counts. For example, if you enter NOMAP, and then later 
decide you want a locate map, you can enter the MAP control without error. The 
second version of the control is recognized and the first is ignored. 

At the end of this document you will find operating system-specific examples of the 
LOC86 controls. Fold out the pages containing the examples relevant to your 
operating environment and use them in conjunction with the syntax conventions 
provided in this chapter. 
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Table 5-1 . Summary of LOC86 Controls 


Control 

Abbrev. 

Default 

ADDRESSES! 

{SEGMENTS! {segmen![\c/ass[\o^er/ay|] 
(addr)y[....]) \ 

CL^SSES{iclass{addr)y[,...]) \ 
GROUPS!{g/'oup!ac/c!r)>[,...]) } 

AD 
!SM I 
CS|GR) 

Not applicable 

BOOTSTRAP 

BS 

Not applicable 

COMMENTS 

CM 

COMMENTS 

NOCOMMENTS 

NOCM 


INITCODE[!acya'ress)l 

IC 

INITCODE!200H) 

NOINITCODE 

NOIC 


LINES 

LI 

LINES 

NOLINES 

NOLI 


MAP 

MA 

MAP 

NOMAP 

NOMA 


NAME!moc!u/e) 

NA 

Not applicable 

OBJECTCONTROLS! 

{LINES I NOLINES | 

COMMENTS 1 NOCOMMENTS | 
SYMBOLS 1 NOSYMBOLS | 
PUBLICS 1 NOPUBLICS | 
PURGE 1 NOPURGE>[,...]) 

OC 

Not applicable 

ORDER! 

{SEGMENTS!{segmen/[ \class[\ overlay]]} 

l-])\ 

CL/KSSES(iclass[(segment [,...])]} [,...1)} [,...]) 

OD 

!SM |CS) 
CS 

Not applicable 

PRWJ[{pathname)\ 

PR 

PRINT!ob;ectft/e.MP2) 

NOPRINT 

NOPR 


PRINTCONTROLS!{LlNES | NOLINES | 

COMMENTS 1 NOCOMMENTS | 
SYMBOLS 1 NOSYMBOLS | 
PUBLICS 1 NOPUBLICS | 
PURGE 1 NOPURGE}[,...l) 

PC 

Not applicable 

PUBLICS 

PL 

PUBLICS 

NOPUBLICS 

NOPL 


PURGE 

PU 

NOPURGE 

NOPURGE 

NOPU 


RESERVE!{ac/c/rTOac!c!r} [,..,D 

RS 

Not applicable 

SEGSIZE! {segment! \c/ass[\oi^er/ay]) 
(size)} 

SS 

Not applicable 

START (isymbol \ paragraph ,offset } ) 

ST 

Not applicable 

SYMBOLS 

SB 

SYMBOLS 

NOSYMBOLS 

NOSB 


SYMB0LC0LUMNS!{1I2I3I4>) 

SC 

SYMBOLCOLUMNS!2) 
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ADDRESSES 


Syntax 

ADDRESSES ({SEGMENTS ({segment name[\class name 

[\overlay name]] (address) } 

[....]) I 

C LAS S ES ( {class name (address) >[,...]) | 
GROUPS ({group name (address) }[, ...]) } 

[,...] 

) 


Abbreviation 

AD(SM| CS I GR) 

Default 

Not applicable 


Definition 

ADDRESSES allows you to override LOC86’s default address assignment 
algorithm. You may assign a beginning address to segments, classes, or groups. All 
addres.ses must follow Intel rules for integer representation. (These rules are the 
same as those used by ASM86 and PL/M-86.) The subcontrols, SEGMENTS, 
CLASSES, and GROUPS, identify exactly what elements of the input module are 
being assigned addresses. When assigning an address with the SEGMENTS sub- 
control, you may also specify the class name and overlay name of the particular 
segment. 

LOC86 attempts to detect and avoid conflicts whenever possible. If the specified 
address does not agree with the alignment attribute of the specified segment or the 
first segment in the specified class, then the address is ignored. If an absolute seg- 
ment is located at the address assigned to a class, then the class begins at the first free 
address after the absolute segment. If you assign a non-paragraph address to a 
group, LOC86 will assign the first paragraph address below the specified address. 


Notes 

• The subcontrols SECjMENTS, CLASSES, and GROUPS can be specified 
multiple times in a single ADDRESSES control. 

• If an address assignment causes a conflict with an ORDER control, a 
RESERVE control or an absolute segment, LOC86 generates an error message. 

• When locating bound object modules, you may not assign an address to a 
segment in a group. 
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Syntax 

BOOTSTRAP 


Abbreviation 

BS 

Default 

Not applicable 


Definition 

BOOTSTRAP indicates that the code for a long jump to the module’s start address 
should be placed at location OFFFFOH, when the module is loaded. This is the first 
instruction executed by the 8086 after reset. If the input module has no start address 
and none is specified in the START control, LOC86 will generate an error message. 


Notes 

• See also the START and INITCODE controls. 
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COMMENTS/NOCOMMENTS 


Syntax 

COMMENTS 

NOCOMMENTS 

Abbreviation 

CM 

NOCM 


Default 

COMMENTS 


Definition 

COMMENTS allows object file comment records to remain in the output module. 
The NOCOMMENTS control removes all comment records except those designated 
as non-purgable. 

Comment records are added to the object module for various reasons. All 
translators add a comment record to the object files they produce. The record iden- 
tifies the compiler or assembler that produced the object file. 

Comment records are superfluous to the production of executable code and may be 
removed at any time during the development process, or left in the file. 


Notes 

• See PRINTCONTROLS, OBJECTCONTROLS, and PURGE. 

• Comment records should not be removed when you submit an object file in a 
Software Problem Report. 

• NOCOMMENTS will decrease the size of the output object module. 

• COMMENTS has no effect on the print file. 
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Syntax 

INITCODE[(ac/c/ress)] 

NOINITCODE 

Abbreviation 

IC 

NOIC 

Default 

INITCODE(200H) 


Definition 

INITCODE causes LOC86 to create a new segment that contains code to initialize 
the segment registers. The optional address argument specifies the physical address 
of the code that performs this initialization. If no address is specified, the initializa- 
tion code will be placed at 200H. The equivalent assembly language code is shown 
below: 


STACKFRAME 

DU 

stack frame 

DATAFRAME 

DU 

data frame 

EXTRAFRAME 

DU 

CLI 

extra frame 


MOV 

SS, CSrSTACKFRAME 


MOV 

S P , stack offset 


MOV 

OS, CS:DATAFRAME 


MOV 

ES, CS-.EXTRAFRAME 


JMP 

program start 


Notes 

• The initialization code segment is created only if a register initialization record 
for 8086 segment registers exists in the input. These register initialization 
records are automatically produced by 8086-based translators for main 
modules. 

• If the area of memory used by the INITCODE default is reserved, LOC86 
places the initialization code above the reserved space. 

• If created, the new segment is called 77LOC86 INITCODE. 
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LINES/NOLINES 


Syntax 

LINES 

NOLINES 

Abbreviation 

LI 

NOLI 

Default 

LINES 

Definition 

LINES allows line number information to remain in the object file. In-circuit 
emulators and other debuggers use this information; it is not needed to produce 
executable code. The NOLINES control removes this information from the output 
file. 

Notes 

• The scope of the LINES control can be modified with PRINTCONTROLS and 
OBJECTCONTROLS. 

• See the PURGE control. 

® NOLINES will decrease the size of the output object file. 
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Syntax 

MAP 

NOMAP 


Abbreviation 

MA 

NOMA 

Default 

MAP 


Definition 

MAP causes LOC86 to produce a locate map for the output module and add it to the 
print file. For all segments in the module the map shows the complete name (seg- 
ment name, class name, and overlay name), size, alignment, start address, and stop 
address. A more complete description of the locate map and the rest of the print file 
is at the end of this chapter. 


Notes 

• MAP can be overridden by the NOPRINT control. 
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NAME 


Syntax 

NAME (module name ) 

Abbreviation 

NA 


Default 

Module retains its current name. 


Definition 

NAME assigns the specified module name to the output module. If NAME is not 
specified, then the output module retains its current name. 

The module name may be up to 40 characters long. It may be composed of any of 
the following characters in any order: 

? (question mark) 

@ (commercial at) 

: (colon) 

. (period) 

(underscore) 

A, B, C, ...,Z 
0, 1,2, ...,9. 

Lower case letters may be used, but they are automatically converted to upper case. 


Notes 

• NAME does not affect the output file’s name, only the module name in the 
output module’s header record. 
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Syntax 


OBJECTCONTROLS({LINES | NOLINES | 

COMMENTS I NOCOMMENTS | 
SYMBOLS I NOSYMBOLS | 
PUBLICS 1 NOPUBLICS | 
PURGE I N0PUR6E} 


) 


Abbreviation 

oc 


Default 

Controls apply to both the print file and the object file. 


Definition 

OBJECTCONTROLS causes the controls specified in its arguments to be applied to 
the object file only. Comment records, line number records, local and public symbol 
records, and symbol type records are selectively included or excluded from the 
object file. This will not affect the print file and the information contained in it. 


Notes 

• If you specify an invalid control in the arguments to OBJECTCONTROLS, 
LOC86 generates an error message. 

• You may specify a control or control pair more than once within 
OBJECTCONTROLS, but only the last version specified counts. 

• You may abbreviate the controls used within OBJECTCONTROLS. 

• When you specify a control in both OBJECTCONTROLS and 
PRINTCONTROLS, it will have the same effect as specifying it once outside of 
these controls. 
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ORDER 


Syntax 

ORDER({SEGMENTS( {segment name[\class name[\overlay name]] > 

[,...]) I 

ZlkSSlS iMclass name[isegment name [,...])]> [,...])} 


Abbreviation 

0D(SM|CS1) 


Default 

Not applicable 


Definition 

ORDER specifies a partial or complete order for segments, classes, and the segments 
within a class. Segments and classes listed in ORDER are located before any other 
relocatable segment. 

The subcontrol SEGMENTS indicates that the list of segment names shall be 
ordered. 

The segment name identifies the specific segments to be ordered. The \class name 
and \ overlay name may be used to resolve conflicts with duplicate segment names. 
If \overlay name is specified, the \class name is required. 

If one of the segments specified is not contained in the designated group, an error 
message is generated. 


Notes 

• See “LOC86’s Algorithm for Locating Segments” at the end of this chapter. 
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Syntax 

PRIUI [{pathname) ] 
NOPRINT 


Abbreviation 

PR 

NOPR 

Default 

P R I N T ( object file . M P 2 ) 


Definition 

PRINT allows you to direct the locate map symbol table and other diagnostic 
information to a particular file. If the PRINT control is not specified or if the con- 
trol is given without an argument, the print file will have the same pathname as the 
output file except the extension will be .MP2. NOPRINT prevents the creation of 
this file. 


Notes 

• The discussion at the end of this chapter describes the contents of the print file. 

• See also MAP, SYMBOLCOLUMNS, LINES, SYMBOLS, PUBLICS, and 
PRINTCONTROLS. 
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PRINTCONTROLS 


Syntax 

PRINTCONTROLS ({LINES | NOLINES | 

COMMENTS I NOCOMMENTS | 
SYMBOLS I NOSYMBOLS | 
PUBLICS I NOPUBLICS | 
PURGE I NOPURGE) 


Abbreviation 

PC 

Default 

Controls apply to both the print file and the objeet file. 


Definition 

PRINTCONTROLS causes the controls specified in its arguments to be applied to 
the print file only. Line number information, and local and public symbol informa- 
tion are selectively included or excluded from the print file. This will not affect the 
object file or the information contained in it. 


Notes 

• If you specify an invalid control in the arguments to PRINTCONTROLS, 
LOC86 generates an error message. 

• You may specify a control in OBJECTCONTROLS more than once, but only 
the last version specified counts. 

• You may abbreviate the controls used within PRINTCONTROLS. 

• When you specify a control in both PRINTCONTROLS and 
OBJECTCONTROLS, it will have the same effect as specifying it once outside 
of these controls. 
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Syntax 

PUBLICS 

NOPUBLICS 

Abbreviation 

PL 

NOPL 

Default 

PUBLICS 


Definition 

PUBLICS causes the public symbol records to be kept in the object file and the 
corresponding information to be placed in the print file. 


Notes 

• The scope of PUBLICS can be modified by PRINTCONTROLS and 
OBJECTCONTROLS. 

• NOPUBLICS will reduce the size of the output object file; however, public 
symbol records are used by debuggers. 

• See the PURGE control. 
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PURGE/NOPURGE 


Syntax 

PURGE 

N0PUR6E 

Abbreviation 

PU 

NOPU 

Default 

NOPURGE 


Definition 

PURGE is exactly the same as specifying NOLINES, NOSYMBOLS, 
NOCOMMENTS, and NOPUBLICS. NOPURGE in the control list is the same as 
specifying LINES, SYMBOLS, COMMENTS, and PUBLICS. 

PURGE removes all of the public and debug information from the object file and 
the print file. It will produce the most compact object file possible. The records that 
would be included by NOPURGE are useful to debuggers and in-circuit emulators, 
but otherwise they are unnecessary for producing executable code. 


Notes 

• PRINTCONTROLS and OBJECTCONTROLS can be used to modify the 
scope of PURGE. 
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Syntax 

RESERVE ({ac/cyress 7 TO address2} [,...]) 

Abbreviation 

RS 


Default 

All of memory is assumed available. 


Definition 

RESERVE prevents LOC86 from locating segments in certain areas of memory. 
LOC86 will not use all memory addresses from addressi to address2 inclusive; 
addressi must be less than or equal to address2. 


Notes 

• If an absolute segment uses a reserved memory area, a warning message is 
generated. 

• Reserved areas may overlap. 
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SEGSIZE 


Syntax 

S EG S I Z E ( {segment name[\class name[\overlay name]] (size) } 

Abbreviation 

SS 

Default 

Not applicable 

Definition 

SEGSIZE allows you to specify the memory space used by a segment. 

The segment name may be any segment contained in the input module. 

The size is a 16-bit number that LOC86 uses to change the size of the specified seg- 
ment. There are three ways of specifying this value; 

• + indicates that the number should be added to the current segment length. 

• — indicates that the number should be subtracted from the current segment 
length. 

• No sign indicates that the number should become the new segment length. 

Notes 

• LOC86 issues a warning message when SEGSIZE decreases the size of a 
segment. 
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Syntax 

S T A R T ( {public symbol | paragraph , offset } ) 

Abbreviation 

ST 

Default 

The start address designated in the input module 

Definition 

START allows you to specify the start address of your program. 

If you specify pt//?//c symbol, that symbol must be defined within the input module. 

The paragraph value initializes the CS register and the offset value initializes the IP 
in an 8086 long jump when your program is started. 

Notes 

• See the BOOTSTRAP and INITCODE controls. 
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SYMBOLS/NOSYMBOLS 


Syntax 

SYMBOLS 

NOSYMBOLS 

Abbreviation 

SB 

NOSB 


Default 

SYMBOLS 


Definition 

SYMBOLS specifies that all local symbol records shall be included in the object file, 
and information concerning local symbols will also appear in the symbol table con- 
tained in the print file. Local symbol records are used by debuggers and in-circuit 
emulators. 


Notes 

• The scope can be modified by OBJECTCONTROLS and PRINTCONTROLS. 

• NOSYMBOLS will decrease the size of the output object file. 

• See the PURGE control. 


5-19 



SYMBOLCOLUMNS 


iAPX 86,88 Family Utilities 


Syntax 

SYMB0LC0LUMNS({1 |2|3|4}) 

Abbreviation 

SC 

Default 

SYMB0LC0LUMNS(2) 


Definition 

SYMBOLCOLUMNS indicates the number of columns to be used when producing 
the symbol table for the object module. Two columns fit on a 78-character line; four 
columns fit on a single 128-character line printer line. 


Notes 

None 
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LOC86’s Print File 

The print file is always created unless you specify NOPRINT. The optional argu- 
ment to PRINT designates the name of the print file. The default print file is the 
object file with the extension .MP2. 

The print file may contain as many as three parts; 

• A symbol table 

• A memory map 

• An error message list 

The symbol table is included in the print file when a PUBLICS, LINES, or 
SYMBOLS control is in effect. The memory map is controlled by the 
MAP/NOMAP control. Error and warning messages, if any, are always added to 
the print file. 


The Symbol Table 

LOC86 produces a symbol table when any or all of the symbol controls (LINES, 
SYMBOLS, and PUBLICS) are in effect. No symbol table will be produced when 
PURGE is in effect for the print file. 

Figure 5-2 shows LOC86’s symbol table with the SYMBOLCOLUMNS set at 2 (the 
default). 

BASE is usually a 4-digit hexadecimal number that is the base address of the group 
that contains the symbol. If the base is the stack, then STACK is used instead of a 
number. If the symbol is based on another symbol’s value, then the BASE and 
OFFSET values for that symbol are given. 

OFFSET is a 4-digit hexadecimal number that is the offset of the symbol or line 
from BASE, or from the current BP for stack symbols. 

To compute the physical aiddress of the specified symbol you would use the follow- 
ing equation: 

(BASE * lOH) + OFFSET = Physical Address 

Of course, the physical address of the symbols whose base is the STACK, or symbols 
that are based on another symbol’s value, cannot be computed until run-time. 

TYPE describes the kind of symbol it is. There are four possible entries in the TYPE 
column: 

BAS based on another symbol’s value 
LIN line (not a symbol) 

PUB public symbol 
SYM local symbol 

SYMBOL field contains the name of the symbol or number of the line. If the 
SYMBOLCOLUMNS value is 1, this field is 40 characters wide. If the 
SYMBOLCOLUMNS value is 2 or more, then this field is 16 characters wide. If the 
symbol name is longer than the width of the entry, then the name is hyphenated and 
continued in the SYMBOL, field on the next line. 
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MODULE s ROOT 


BASE 

OFFSET 

TiPE 

SYMBOL 

BASE 

OFFSET 

TYPE 

SYMBOL 

OOBBH 

OFAOH 

STM 

MEMORY 

OOBBH 

0006H 

SYM 

COPYRIGHT 

OOBBH 

001CH 

STM 

BUFLEN 

OOBBH 

001EH 

SYM 

BUFBASE 

0020H 

OOF7H 

SYM 

ERROR 

0020H 

OOFEH 

SYM 

WARNING 

OOBBH 

0020H 

SYM 

LASTNMNODEP 

OOBBH 

0022H 

SYM 

FIRSTNMNODEP 

OOBBH 

002‘IH 

SYM 

LASTSGNODEP 

OOBBH 

0026H 

SYM 

FIRSTSGNODEP 

OOBBH 

0028H 

SYM 

LASTTDNODEP 

OOBBH 

002AH 

SYM 

FIRSTTDNODEP 

OOBBH 

002CH 

SYM 

LASTEXNODEP 

OOBBH 

002EH 

SYM 

FIRSTEXNODEP 

OOBBH 

0030H 

SYM 

LASTGRNODEP 

OOBBH 

0033H 

SYM 

FIRSTGRNODEP 

OOBBH 

003‘tH 

SYM 

LASTOVNODEP 

OOBBH 

0036H 

SYM 

FIRSTOVNODEP 

OOBBH 

0038H 

SYM 

LASTBNODEP 

OOBBH 

003AH 

SYM 

FIRSTBNODEP 

OOBBH 

003CH 

SYM 

SGHODEBASE 

OOBBH 

003EH 

SYM 

GRNODEBASE 

OOBBH 

OOllOH 

SYM 

SYNODEBASE 

OOBBH 

0042H 

SYM 

NMNODEBASE 

OOBBH 

OOi(4H 

SYM 

TDNODEBASE 

OOBBH 

0046H 

SYM 

FFNODEBASE 

OOBBH 

0048H 

SYM 

OVNODEBASE 

OOBBH 

004AH 

SYM 

FENODEBASE 

OOBBH 

004CH 

SYM 

FDNODEBASE 

OOBBH 

004EH 

SYM 

FANODEBASE 

OOBBH 

0050H 

SYM 

FBNOOEBASE 

OOBBH 

0052H 

SYM 

BNODEBASE 

OOBBH 

0084H 

SYM 

CLASHNODEBASE 

OOBBH 

OOgbH 

SYM 

FIRSTRENAMEBLOCK 


-P 




Figure 5-2. LOC86 Symbol Table 
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The Memory Map 

The memory map supplies useful information about segment placement and address 
assignment. Figure 5-3 shows LOC86’s memory map. 

The map consists of three parts: 

• Header 

• Segment map 

• Group map 

The header includes the input module name and the start address. 

The segment map is a table with six columns. From left to right the columns show: 

• the START address of the segment 

• the STOP address of the segment 

• the LENGTH of the segment 

• the ALIGNMENT attribute of the segment 

• the NAME of the segment 

• the CLASS of the segment 

• the OVERLAY of the segment 

A “C” printed between the STOP and LENGTH columns indicates that two 
segments have overlapping memory locations; a warning message is also issued. 

A segment may have any one of the following alignment attributes: 

A absolute 
B byte 
6 paragraph 

M member of an LTL group 
P page 
W word 
R in-page 



Figure 5-3. LOC86 Memory Map 
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In-page alignment means that the entire segment must be resident within a single 
256-byte page. The address of the first byte in any page has zeros in the first two 
hexadecimal digits (OOH, lOOH, 200H,... OFFFOOH). 

The group map has two columns: the first is the physical address (five-digit hexa- 
decimal number) of the beginning of the group; the second column is the group 
name, followed by the segments contained in that group. The segment names con- 
tained within a given group are listed in the same column but indented slightly. 


Error and Warning Messages 

The error and warning messages are listed consecutively as the error situations are 
encountered. 

See the discussion of the interpretation of individual messages in Appendix F. 


LOC86’s Algorithm for Locating Segments 

Assuming that there are no errors in the invocation line or input module, LOC86 
locates an input module in three stages. 

1. All absolute segments are removed from the list of segments contained in the 
module. 

2. The remaining relocatable segments are ordered into a sequential list. 

3. The relocatable segments are then given absolute addresses according to each 
segment’s alignment, size, and memory attribute. 


Absolute Segments 

When LOC86 encounters an absolute segment, LOC86 removes the segment from a 
list of input segments and reserves the memory area used by that segment. LOC86 
maintains a map of free memory. Each time an absolute segment is encountered, the 
memory space used by that segment is removed from the memory map. A segment 
can become absolute in one of three ways: 

1 . It may be assigned an absolute address by the translator. 

2. It may be explicitly specified in an ADDRESSES control. 

3. It may become absolute implicitly. If an absolute segment is specified in an 
ORDER control, then all other segments referred to in that control, either by 
segment name or by class name, are treated as absolute. 


Segment Ordering 

After all memory used by absolute segments has been removed from LOC86’s free 
memory map and before LOC86 begins assigning addresses to the remaining 
relocatable segments, LOC86 prepares an ordered list of all relocatable segments. 

All relocatable segments specified in an ORDER control are placed at the head of 
the list. 
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After all ORDER controls, if any, have been processed, LOC86 adds the relocatable 
segments that remain to the end of the list. If the first segment not previously used 
has a class name, then all other segments with the same class name are added to the 
list. After all segments of the class have been added to the list, then the next segment 
is added to the list. 

This process continues until all segments have been added to the ordered list. 


NOTE 

Memory segments do not adhere to this process — a memory segment is 
always located at the top of memory, if possible. If an input module con- 
tains more than one memory segment, only the first is placed at the top of 
memory; the other segments are treated as any other relocatable segment. 


Assigning Addresses to Relocatable Segments 

Once LOC86 completes the ordered list of relocatable segments, it begins assigning 
addresses. LOC86 will never assign addresses that conflict with the location of 
absolute segments or the RESERVE control or between OOH and 200H, since that 
area is reserved for interrupt routines. 

Starting at location 200H, LOC86 scans free memory to find an area in which the 
first segment will fit. When LOC86 finds a suitable address, it assigns it to the seg- 
ment and removes that area from free memory. LOC86 then scans free memory for 
an area that will fit the next segment in the ordered list. LOC86 begins scanning at 
the end of the previous segment. 

IF LOC86 reaches the end of memory and all of the relocatable modules have not 
been located, it makes an additional scan through free memory. The scanning pro- 
cess continues until all modules have been located. 


LOC86’s Algorithm for Locating Modules 
Containing Overlays 

LOC86 locates programs with overlays in much the same way as it handles programs 
that do not contain overlays. However, there are some differences. 

1 . Segments contained in the root and each overlay are ordered separately. 

2. Segments that are common to both the root and overlays (e.g., STACK and 
MEMORY) are put at the end of the list of relocatable segments. 

3 . Segments in the root are located at the lowest available addresses in memory. 

4. Segments contained in the overlays are located at the first available address 
above the root. 

5. Segments common to the root and overlays are located immediately above the 
largest overlay in the file. 

Figure 5-4 illustrates how LOC86 treats two PL/M-86 programs that use overlays. 
Figure 5-4a shows how segments are located when the modules are compiled with the 
LARGE model. Figure 5-4b shows how segments are located when the modules are 
compiled with the SMALL model of segmentation. 
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CHAPTER 6 
OH86 


OH86 converts 8086 absolute object modules to 8086 hexadecimal format. The 
input module must be in absolute format, and it may not contain overlays or register 
initialization records. 

Figure 6-1 illustrates the object-to-hexadecimal conversion process. Any errors 
encountered during execution are displayed at the console output device. 

For definition of file-naming conventions and syntax notation, refer to Notational 
Conventions following the Preface. For information on error and warning messages 
which may be produced, refer to Appendix H. 

The general syntax for the invocation line is: 

[directory-name]QHS6 input file[J0 output file] 

The input file contains an 8086 absolute object module. 

TO output file designates the file to receive the 8086 hexadecimal format. If output 
file is not specified, then output is directed to a file that has the same pathname as 
the input list, but its extension is HEX. 

At the end of this document you will find operating system-specific examples of the 
OH86 invocation. 
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Figure 6-1 . OH86 Input and Output Files 121616-9 
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APPENDIX A 
iAPX 86,88 ABSOLUTE OBJECT 

FILE FORMATS 


Introduction 

The 8086 Absolute Object File Format herein described is a proper subset of the full 
8086 Object File Formats. An absolute object file consists of a sequence of records 
defining a single absolute module. An absolute module is defined as a collection of 
absolute object information that is specified by a sequence of object records. 


Definitions 

This section defines certain terms fundamental to 8086 Relocation and Linkage 
(R&L). The terms are ordered not alphabetically, but so you can read forward 
without forward references. 


Definition of Terms 

OMF — acronym for Object Module Formats 
R&L— acronym for Relocation and Linkage 

MAS— acronym for Memory Address Space. The 8086 MAS is one megabyte 
(1,048,576 bytes). Note that the MAS should be distinguished from actual memory, 
which may occupy only a portion of the MAS. 

MODULE — an “inseparable” collection of object code and other information pro- 
duced by a translator or by the LINK86 program. When a distinction must be made: 

T-MODULE — denotes a module created by a translator, such as PL/M-86 or 
ASM86, and 

L-MODULE — denotes a module created by LINK86 from one or more constituent 
modules. (Note that modules are not “created” in this sense by the iAPX86,88 
Locater, LOC86; the output module from LOC86 is merely a transformation of the 
input module). 

Two observations about modules must be made: 

1 . Every module must have a name, so that the iAPX86,88 Librarian, LIB86, has a 
handle for the module for display to the user. (If there is no need to provide a 
handle for LIB86, the name may be null.) Translators provide names for T- 
modules, providing a default name (possibly the file name or a null name) if 
neither source code nor user specifies otherwise. 

2. Every T-module in a collection of modules linked together may have a different 
name, so that symbolic debugging systems can distinguish the various symbols. 
This restriction is not required by R&L and is not enforced by it. 

FRAME— a contiguous region of 64K of MAS, beginning on a paragraph boundary 
(i.e., on a multiple of 16 bytes). This concept is useful because the content of the 
four 8086 segment registers define four (possibly overlapping) FRAME’S; no 16-bit 
address in the 8086 code can access a memory location outside T the current four 
frame’s. The FRAME starting at address OOOOH is FRAME 0. 
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Module Identification 


In order to determine that a file contains an object program, a module header record 
will always be the first record in a module. There are two kinds of header records 
and each provides a module name. The additional functions of the header records 
are explained below. 

A module name may be generated during one of two processes: translation or link- 
ing. A module that results from translation is called a T-MODULE. A T-MODULE 
will have a T-MODULE HEADER RECORD (THEADR). A name may be 
provided in the THEADR record by a translator. This name is then used to identify 
the progenitor of all debug information found in the T-MODULE. The name may 
be null, i.e., of length zero. 

A module that results from linking and locating is called an L-MODULE. An 
L-MODULE will always have an L-MODULE HEADER RECORD (LHEADR) or 
an R-MODULE HEADER RECORD (RHEADR). In the LHEADR or RHEADER 
record a name is also provided. This name is available for use to refer to the module 
without using any of its constituent T-MODULE names. An example would be two 
T-MODULES, A and B, linked together to form L-MODULE C. L- MODULE C 
will contain two THEADR records and will begin with an LHEADR record with the 
name C provided by the linker as a directive from the user. The L- MODULE C can 
be referred to by other tools such as the library manager without having to know 
about the originating module’s names, yet the originating module’s names are 
preserved for debugging purposes. 


Module Attributes 


In addition to a name, a module may have the attribute of being a main program as 
well as having a specified starting address. 

If a module is not a main module yet has a starting address, then this value has been 
provided by a translator, possibly for debugging purposes. A starting address 
specified for a non-main module could be the entry point of a procedure, which may 
be loaded and initiated independent of a main program. 


Physical Segment Definition 


A module is defined as a collection of data bytes defined by a sequence of records 
produced by a translator. The data bytes represent contiguous regions of memory 
whose contents are determined at translation time. 


Physical Segment Addressability 


The 8086 addressing mechanism provides segment base registers from which a 64K 
byte region of memory, called a Frame, may be addressed. There is one code seg- 
ment base register (CS), two data segment base registers (DS, ES), and one stack seg- 
ment base register (SS). 
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Data 

The data that defines the memory image represented by a module is maintained in 
two varieties of DATA records: PHYSICAL ENUMERATED DATA RECORD 
(PEDATA) and PHYSICAL ITERATED DATA RECORD (PIDATA). Both 
records specify the data to be loaded into a contiguous section of memory. The start 
address of this contiguous section is given in the record. PEDAI A records contain 
an exact byte-by-byte copy of the desired memory image. The PIDATA record dif- 
fers in that the data bytes are represented within a structure that must be expanded 
by the loader. The purpose of the PIDATA record is to reduce module size by 
encoding repeated data rather than explicitly enumerating each byte, as the 
PEDATA record does. 


Record Syntax 


The following syntax shows the valid orderings of records to form an absolute 
module. In addition, the given semantic rules provide information about how to 
interpret the record sequence. The syntactic description language used herein is 
defined in Wirth: CACM, November 1977, V20, N 1 1, pg. 822-823. 


absolute object file 

module 

tmod 

Imod 

omod 


o,__component 

Lcomponent 

contenLdef 

mod„tail 


=module. 

=tmod I Imod | omod. 

=THEADR [RiEGINTjcontent def mod _tail. 
=LHEADR [REGlNT]t__component mod_tail. 

=RHEADR {OVLDEF>[REGINT] o^„component 
fOVLDEF> mod tail. 

=Lcomponent ENDREC. 

=[THEADR] content„def 
= PEDATA I PIDATA. 

=[REGINT] MODEND. 


NOTE 

The character strings represented by capital letters above are not literals but 
are identifiers that are further defined in the section defining the Record 
Formats. 

One module may not contain more than one REGINT record and more than one 
OVLDEF sequence. If a REGINT record and an OVLDEF sequence exist, the 
REGINT record must immediately follow the OVLDEF sequence. 

A proper Absolute Object File produced by Intel products will contain at least the 
above record types. It may also contain other record types which, if present, will 
follow the Module Header record and precede the Module End record. These other 
record types fall into two categories: 

1. Extraneous, containing information not pertinent to an absolute loader. The 
record numbers in this category are: 

72H, 74H, 7AH, 7CH, 7EH, 88H, 8CH, 8EH, 90H, 92H, 94H, 96H, 98H, 9AH, 9CH 

2. Erroneous, containing information about relocation, indicating that the object 
module is not yet in absolute form or that erroneous record types exist. The 
record numbers in this category are all other record type numbers. 
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Record Formats 


The following pages present diagrams of Record Formats in schematic form. Here is 
a sample, to illustrate the various conventions: 


Sample Record Format (SAMREC) 






REC 

RECORD 

NAME 

CHK 

TYP 

LENGTH 


SUM 

xxH 





^ — rpt 



Title and Official Abbreviation 

At the top is the name of the Record Format described, together with an official 
abbreviation. To promote uniformity among various programs, the abbreviation 
should be used in both code and documentation. The abbreviation is always six 
letters. 


The Boxes 

Each format is drawn with boxes of two sizes. The narrow boxes represent single 
bytes. The wide boxes represent two bytes (or one word) each. In the object file, the 
low order byte of a word value comes first. The wide boxes with four vertical bars in 
the top and bottom represent 4-byte fields. The wide boxes with three dots in the top 
and bottom represent a variable number of bytes, one or more, depending upon 
content. 


Rec Typ 

The first byte in each record contains a value between 0 and 255, indicating the type 
of record. 


Record Length 

The second field in each record contains the number of bytes in the record, exclusive 
of the first two fields. 


Name 

Any field that indicates a “NAME” has the following internal structure: the first 
byte contains a number between 0 and 40, inclusive, that indicates the number of 
remaining bytes in the field. The remaining bytes are interpreted as a byte string; 
each byte must represent the ASCII code of a character drawn from this set: 

[?@ :._0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ ] 

Most translators will choose to constrain the character set more strictly; the above 
set has been chosen to “cover” that required by all current processors. 
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Repeated Fields 

Some portions of a Record Format contain a field or series of fields that may occur 
an indefinite number of times (zero or more). Such fields are indicated by the 
“repeated” or “rpt” brackets below the boxes. 

Similarly, some portions of the Record Format are present only if some given condi- 
tion obtains; these fields are indicated by similar “conditional” brackets below the 
boxes. 

Chk Sum 

The last field in each record is a check sum, which contains the two’s complement of 
the sum (modulo 256) of all other bytes in the record. Therefore, the sum (modulo 
256) of all bytes in the record equals 0. 


Bit Fields 

Descriptions of contents of fields will sometimes get down to the bit level. Boxes 
with vertical lines drawn through them represent bytes or words; the vertical lines in- 
dicate bit boundaries; thus this byte has three bit-fields of three, one, and 
four bits: 



Ignored Records 


REC 

RECORD 

IGNORE 

CHK 

TYP 

LENGTH 

THIS 

SUM 



PART 



All record types that may be in an object module that provide information not perti- 
nent to an absolute loader must be ignored. They may all be treated as if they have 
the above format. Records in this category have RFC TYP in the set 72H, 74H, 
7AH, 7CH, 7EH, 88H, 8CH, 8EH, 90H, 92H, 94H, 96H, 98H, 9AH, 9CH. 


T-Module Header Record (THEADR) 


REC 

RECORD 

T 

CHK 

TYP 

LENGTH 

MODULE 

SUM 

80H 


NAME 



Every module output from a translator must have a T-MODULE HEADER 
RECORD. Its purpose is to provide the identity of the original defining module for 
all debug information encountered in the module up to the following T-MODULE 
HEADER RECORD or MODULE END RECORD. 

This record can also serve as the header for a module; i.e., it can be the first record 
and will be for modules that are output from translators. 
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T-Module Name 

The T-MODULE NAME provides a name for the T-MODULE. 

L-Module Header Record (LHEADR) 


REC 

RECORD 

L 

CHK 

TYP 

LENGTH 

MODULE 

SUM 

82H 


NAME 



A module created by LINK86 and LOC86 may have an L-MODULE HEADER 
RECORD. This record serves only to identify a module that has been processed 
(output) by LINK86 and/or LOC86. When several modules are linked to form 
another module, the new module requires a name, perhaps unique from those of the 
linked modules, by which it can be referred to {by the L1B86 program, for example). 


L-Module Name 

The L-MODULE NAME* provides a name for the L-Module. 

R-MODULE HEADER RECORD (RHEADR) 


REC 

RECORD 

R-MODULE 

OVERLAY 

CHK 

TYP 

LENGTH 

NAME 

INFO 

SUM 

6EH 






Every module with overlays created by L1NK86/LOC86 will have an R-MODULE 
HEADER RECORD. This record serves to identify a module that has been pro- 
cessed (output) by LINK86/LOC86. It also specifies the overlay count and the loca- 
tion of the Overlay Definition records. When several modules are linked to form 
another module, the new module requires a name, perhaps unique from those of the 
linked modules, by which it can be referred to. 


R-MODULE NAME 

The R-MODULE NAMEi provides a name for the R-Module. 

OVERLAY INFO 

The OVERLAY INFO field provides information on overlays in the module and has 
the following format: 


IGNORE 

OVERLAY 

OVERLAY 

IGNORE 

THIS 

RECORD 

RECORD 

THIS 

PART 

COUNT 

OFFSET 

1 1 1 1 

PART 


The first subfield is a 5-byte field that should be ignored. 
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The OVERLAY RECORD COUNT subfield indicates the number of Overlay 
Definition Records in the module. 

The OVERLAY RECORD OFFSET subfield is a 4-byte field. It contains a 32-byte 
unsigned number indicating the location in bytes, relative to the start of the object 
file, of the first Overlay Definition Record in the Module. 

The last subfield is a 16-byte field that should be ignored. 


OVERLAY DEFINITION RECORD (OVLDEF) 


REC 

RECORD 

OVERLAY 

TYP 

LENGTH 

NAME 

76H 




OVERLAY 

LOCATION 


Z 

CHK 


SUM 


This Record provides the overlay name, the location of the overlay in the object file. 


A loader may use this record to locate the data records of the overlay in the object 
file. 


OVERLAY NAME 

The OVERLAY NAME field provides a name by which a collection of data records 
may be referenced for loading. 


OVERLAY LOCATION 

The OVERLAY LOCATION is a 4-byte field which gives the location in bytes 
relative to the start of the file of the first byte of the records in the overlay. 


z 

The Z field is a reserved field. This field is required to be zero. 

END RECORD (ENDREC) 


REC 

RECORD 

END 

CHK 

TYP 

LENGTH 

TYP 

SUM 

78H 





This record is used to denote the end of a set of records such as records in an 
overlay. 
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ENDTYP 

This field specifies the type of the set. It has the following format: 


0 

0 

0 

0 

0 

0 

I 

TYP 

1 


TYP is a two bit subfield that specifies the following types of ends: 


TYP 


TYPE OF END 


End of overlay 
(Reserved) 
(Illegal) 
(Illegal) 


REGISTER INITIALIZATION RECORD (REGINT) 


REC 

RECORD 

REG 

REGISTER 

CHK 

TYP 

LENGTH 

TYP 

CONTENTS 

SUM 

70 H 






I repeated > 

This record provides information about the 8086 registers/register-pairs: CS and 
IP, SS and SP, DS and ES. The purpose of this information is for a loader to set the 
necessary registers for initiation of execution. 


REG TYP 

The REG TYP field provides the register/register-pair name. It has the following 
format: 


REGID 

0 

0 

0 

0 

0 

0 


REGID is a two bit subfield that specifies the name of the registers/register-pairs as 
follows: 


REGID REGISTER/REGISTERPAIR 

0 CSandIP 

1 SS and SP 

2 DS 

3 ES 
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REGISTER CONTENTS 

The REGISTER CONTENTS field has the following format: 


z 

z 

FRAME 

NUMBER 

REGISTER 

OFFSET 


conditional 


The Z fields are reserved fields. They are required to be zero. 

The FRAME NUMBER field specifies a frame number that must be used to 
initialize the base register indicated by the REGID value. 

The REGISTER OFFSET field, present only if REGID <= 1, specifies an offset 
relative to the FRAME. This value is appropriate for the initialization of either the 
IP register (REGID = 0) or the SP register (REGID = 1). 


Module End Record (MODEND) 


REG 

RECORD 

MOD 

START 

CHK 

TYP 

LENGTH 

TYP 

ADDRS 

SUM 

8AH 







conditional 



This record serves two purposes. It denotes the end of a module and indicates 
whether the module just terminated has a specified entry point for initiation of 
execution. If the latter is true, then the execution address is specified. 


Mod Typ 

This field specifies the attributes of the module. The bit allocation and their 
associated meanings are as follows: 


MATTR 


MATTR is a two-bit subfield that specifies the following module attributes: 

MATTR MODULE ATTRIBUTE 

0 Non-main module with no starting address 

1 Non-main module with starting address 

2 (invalid value for MATTR) 

3 Main module with starting address 
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Start Addrs 


The START ADRS field has the following format; 


FRAME 

OFFSET 

NUMBER 



FRAME NUMBER. This field specifies a frame number relative to which the 
module will begin execution. This value is appropriate for insertion into the CS 
register for program initiation. 

OFFSET. This field specifies an offset relative to the FRAME NUMBER that 
defines the exact location of the first byte at which to begin execution. This value is 
appropriate for insertion into the IP register for program initiation. 


Physical Enumerated Data Record (PEDATA) 


REG 

RECORD 

FRAME 

OFF 


CHK 

TYP 

LENGTH 

NUMBER 

SET 

DAT 

SUM 

84 H 







I rpt 1 

This record provides contiguous data, from which a portion of an 8086 memory 
image may be constructed. 

Frame Number 

This field specifies a Frame Number relative to which the data bytes will be loaded. 

Offset 

This field specifies an offset relative to the FRAME NUMBER which defines the 
location of the first data byte of the DAT field. Successive data bytes in the DAT 
field occupy successively higher locations of memory. The value of OFFSET is con- 
strained to be in the range 0 to 15 inclusive. If an OFFSET value greater than 15 is 
desired, then an adjustment of the FRAME NUMBER should be done. 

Dat 

This field provides consecutive bytes of an 8086 memory image. The number of 
DAT bytes is constrained only by the RECORD LENGTH field. The address of 
each byte must be within the frame specified by FRAME NUMBER. 


Physical Iterated Data Record (PIDATA) 


REG 

RECORD 

FRAME 

OFF 

ITERATED 

CHK 

TYP 

LENGTH 

NUMBER 

SET 

DATA 

SUM 

86H 




BLOCK 



■ repeated ' 

This record provides contiguous data, from which a portion of an 8086 memory 
image may be constructed. It allows initialization of data segments and provides a 
mechanism to reduce the size of object modules when there are repeated data to be 
used to initialize a memory image. 
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Frame Number 

This field specifies a frame number relative to which the data bytes will be loaded. 

Offset 

This field specifies an offset relative to the FRAME NUMBER which defines the 
location of the first data byte in the ITERATED DATA BLOCK. Successive data 
bytes in the ITERATED DATA BLOCK occupy successively higher locations of 
memory. The range of OFFSET is constrained to be between 0 and 15 inclusive. If a 
value larger than 15 is desired for OFFSET, then an adjustment of FRAME 
NUMBER should be done. 

Iterated Data Block 

This repeated field is a structure specifying the repeated data bytes. It is a structure 
that has the following format: 


REPEAT 

BLOCK 


COUNT 

COUNT 

CONTENT 


Repeat Count. This field specifies the number of times that the CONTENT portion 
of this ITERATED DATA BLOCK is to be repeated, and must be greater than zero. 

Block Count. This field specifies the number of ITERATED DATA BLOCKS that 
are to be found in the CONTENT portion of this ITERATED DATA BLOCK. If 
this field has value zero then the CONTENT portion of this ITERATED DATA 
BLOCK is interpreted as data bytes. 

If BLOCK COUNT is non-zero then the CONTENT portion of this ITERATED 
DATA BLOCK is interpreted as that number of ITERATED DATA BLOCKS. 


Content. This field may be interpreted in one of two ways, depending on the value 
of the previous BLOCK COUNT field. 

If BLOCK COUNT is zero, then this field is a one-byte count followed by the 
indicated number of data bytes. 

If BLOCK COUNT is non-zero, then this field is interpreted as the first byte of 
another ITERATED DATA BLOCK. 


NOTE 

From the outermost level, the number of nested ITERATED DATA 
BLOCKS is limited to 17; i.e., the number of levels of recursion is limited 
to 17. 

The address of each data byte must be within the frame specified by 
FRAME NUMBER. 


Hexadecimal Object File Format 

Hexadeeimal object file format is a way of representing an object file in ASCII. 

The funetion of the utility program, 0H86, is to convert 8086 absolute object 
modules to 8086 hexadecimal object modules. 
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The hexadecimal representation of binary is coded in ASCII. For example, the eight- 
bit binary value 0011 1111 is 3F in hexadecimal. To code this ASCII, one eight-bit 
byte containing the ASCII code for 3(00110011 or 33H) and one eight-bit byte con- 
taining the ASCII code for F(0100 01 10 or 46H) are required. This representation 
(ASCII hexadecimal) requires twice as many bytes as the binary. 

There are four different types of records that may make up an 8086 hexadecimal 
object file. They are: 

• Extended Address Record 

• Start Address Record 

• Data Record 

• End of File Record 

Each record begins with a RECORD MARK field containing 3AH, the ASCII code 
for colon (:). 

Each record has a REC LEN field which specifies the number of bytes of informa- 
tion or data which follows the RECTYP field of each record. Note that one byte is 
represented by two ASCII characters. 

Each record ends with a CHECKSUM field that contains the ASCII hexadecimal 
representation of the two’s complement of the eight-bit sum of the eight-bit bytes 
that result from converting each pair of ASCII hexadecimal digits to one byte of 
binary, from and including the RECORD LENGTH field to and including the last 
byte of the DATA field. Therefore, the sum of all the ASCII pairs in a record after 
converting to binary, from the RECORD LENGTH field to and including the 
CHECKSUM field, is zero. 


Extended Address Record 


RECD 

REC 


REC 


CHK 

MARK 

LEN 

ZEROES 

TYP 

USBA 

SUM 


‘02’ 

‘0000’ 

‘02’ 




The 8086 EXTENDED ADDRESS RECORD is used to specify bits 4-19 of the Seg- 
ment Base Address (SBA) where bits 0-3 of the SBA are zero. Bits 4-19 of the SBA 
are referred to as the Upper Segment Base Address (USBA). The absolute memory 
address of a content byte in a subsequent DATA RECORD is obtained by adding 
the SBA to an offset calculated by adding the Load Address Field of the containing 
DATA RECORD to the index of the byte in the DATA RECORD (0, 1, 2, ... n). 
The offset addition is done modulo 64K, ignoring a carry, so that offset wrap- 
around loading (from OFFFFH to OOOOOH) results in wrapping around from the end 
to the beginning of the 64K segment defined by the SBA. The address at which a par- 
ticular data byte is loaded is calculated as: 

SBA + ([DRLA + DRI] MOD 64K) 
where 

DRLA is the DATA RECORD LOAD ADDRESS. 

DRI is the data byte index within a DATA RECORD. 
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When an EXTENDED ADDRESS RECORD defines the value of SBA, the 
EXTENDED ADDRESS RECORD may appear anywhere within an 8086 hexa- 
decimal object file. This value remains in effect until another EXTENDED 
ADDRESS RECORD is encountered. The SBA defaults to zero until an 
EXTENDED ADDRESS RECORD is encountered. 


Reed Mark 

The RECD MARK field contains 03AH, the hex encoding of ASCII 

Rec Len 

The Record Length field contains 3032H, the hex encoding of ASCII ‘02’. 

Zeroes 

The Load Address field contains 30303030H, the hex encoding of ASCII ‘0000’. 


Rec Typ 

The Record Type field contains 3032H, the hex encoding of ASCII ‘02’. 


USBA 

The USBA field contains four ASCII hexadecimal digits that specify the 8086 USBA 
value. The high-order digit is the 10th character of the record. The low order digit is 
the 13th character of the record. 


Chk Sum 

This is the check sum on the REC LEN, ZEROES, REC TYP, and USBA fields. 

Data Record 


RECD 

REC 

LOAD 

REC 


CHK 

MARK 

LEN 

ADDRESS 

TYP 

DATA 

SUM 




‘00’ 




The DATA RECORD provides a set of hexadecimal digits that represent the ASCII 
code for data bytes that make up a portion of an 8086 memory image. The method 
for calculating the absolute address for each byte of DATA is described in the 
discussion of the Extended Address Record. 


Reed Mark 

The RECD MARK field contains 03AH, the hex encoding of ASCII 

Rec Len 

The REC LEN field contains two ASCII hexadecimal digits representing the number 
of data bytes in the record. The high-order digit comes first. The maximum value is 
‘FF’ or 4646H (255 decimal). 
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Load Address 

The LOAD ADDRESS field contains four ASCII hexadecimal digits representing 
the offset from the SBA (see EXTENDED ADDRESS RECORD) defining the 
address at which byte 0 of the DATA is to be placed. The LOAD ADDRESS value is 
used in calculation of the address of all DATA bytes. 


Rec Typ 

The REC TYP field in a DATA record contains 3030H, the hex encoding of 
ASCII ‘00’. 

Data 

The DATA field contains a pair of hexadecimal digits that represent the ASCII code 
for each data byte. The high order digit is the first digit of each pair. 


Chk Sum 

This is the check sum on the REC LEN, LOAD ADDRESS, REC TYPE, and 
DATA fields. 


Start Address Record 


RECD 

REC 


REC 



CHK 

MARK 

LEN 

ZEROES 

TYP 

CS 

IP 

SUM 


‘04’ 

‘0000’ 

‘03’ 





The START ADDRESS RECORD is used to specify the execution start address for 
the object file. Values are given for both the Instruction Pointer (IP) and Code Seg- 
ment (CS) registers. This record can appear anywhere in a hexadecimal object file. 

If a START ADDRESS RECORD is not present in an 8086 hexadecimal file, a 
loader is free to assign a default start address. 


Reed Mark 

The RECD MARK field contains 03AH, the hex encoding for ASCII 


Rec Len 

The REC LEN field contains 3034H, the hex encoding for ASCII ‘04’. 


Zeroes 

The ZEROES field contains 30303030H, the hex encoding for ASCII ‘0000’. 


Rec Typ 

The REC TYP field contains 3033H, the hex encoding for ASCII ‘03’. 
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cs 

The CS field contains four ASCII hexadecimal digits that specify the 8086 CS value. 
The high-order digit is the 10th character of the record; the low-order digit is the 
13th character of the record. 


IP 

The IP field contains the four ASCII hexadecimal digits that specify the 8086 IP 
value. The high-order digit is the 14th character of the record, the low order digit is 
the 17th character of the record. 


Chk Sum 

This is the check sum on the REC LEN, ZEROES, REC TYP, CS, and IP fields. 


End of File Record 


RECD 

REC 


REC 

CHK 

MARK 

LEN 

ZEROES 

TYP 

SUM 


‘00’ 

‘0000’ 

‘01’ 

‘FF’ 


The END OF FILE RECORD specifies the end of the hexadecimal object file. 


Reed Mark 

The RECD MARK field contains 03AH, the ASCII code for colon (;). 


Rec Len 

The REC LEN field contains two ASCII zeroes (3030H). 


Zeroes 

The ZEROES field contains four ASCII zeroes (30303030H). 

Rec Typ 

The REC TYP field contains 303 1 FI, the ASCII code for 01 H . 

Chk Sum 

The CHK SUM field contains 4646H, the ASCII code for FFH, which is the check 
sum on the REC LEN, ZEROES and REC TYP fields. 
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Examples 

Sample Absolute Object File 

The following is an example of an absolute object file. The file contains eight 
records. The eight records perform the following functions: 


Record Function 

1 LHEADR record begins the object module and defines the module 
name. 

2 THEADR record defines the translator-generated module name 
which is the same as the name in the LHEADR record. 

3 PEDATA record defines a contiguous memory image from 00200H 
to 00215H. 

4 PEDATA record defines a contiguous memory image from 00360H 
to 00377H. 

5 PEDATA record defines a contiguous memory image from 00415H 
to 0042BH. 

6 PEDATA record defines a contiguous memory image from 
051620H to 05 1 633 H. 

7 PIDATA record defines a contiguous memory image from 
051 BOOH to 051B1DH. The iterated data consists of three repeti- 
tions of “ABC” (414243H), followed by three repetitions of (four 
repetitions of “D” (44H)), three repetitions of “E” (45H). 

8 MODEND record specifies that the module should be started with 
CS = 5162H and IP = 0005 H. 


(1) 82 0008 0653414D504C45 AE 

(2) 80 0008 0653414D504C45 BO 

(3) 84 001 A 0020 00 
004992DB246DB6FF489 1 D A236CB5FE47 
90D9226BB4FD 63 

(4) 84 00 1C 0036 00 
0062C42688EA4CAE1072D43698FA5CBE 
2082E446A80A6CCE 82 

(5) 84 00 IB 0041 05 
001D3A577491AECBE805223F5C7996B3 
D0ED0A2744617E 72 

(6) 84 0018 5162 00 
00850A8F14991EA328AD32B73CC146CB 
50D55ADF FB 

(7) 86 OOlC 51B0 00 
0003 0000 03 414243 

0003 0002 

0004 0000 01 44 
0003 0000 01 45 FA 

(8) 8 A 0006 CO 5162 0005 F8 


NOTE 

The blank characters and carriage return and line feed characters are 
inserted here to improve readability. They do not occur in an object 
module. This file has been converted to ASCII hex so that it may be printed 
here. All word values (RECORD LENGTH, REPEAT COUNT, etc.) have 
been byte-reversed to improve readability. 
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Sample Absolute Hexadecimal Object File 


The following is the hexadecimal object file representation of the object file given in 
the example above: 


020000020020DC 

10000000004992DB246DB6FF4891DA236CB5FE47B8 

0600100090D9226BB4FD43 

02000002003 6C6 

100000000062C42688EA4CAE1072D43698FA5CBE00 

080010002082E446A80A6CCE30 

02000002004 IBB 

1000050000 1 D3A57749 1 AECBE805223F5C7996B353 

07001500D0ED0A2744617ED3 

02000002516249 

1000000000850A8F14991EA328AD32B73CC146CB98 

0400100050D55ADF8E 

020000025 IBOFB 

1 00000004 1 42434 1424341 424344444444454545 BE 
OEOO 1000444444444545454444444445454524 
040000035162000541 
0000000 IFF 
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APPENDIX B 

HEXADECIMAL-DECIMAL CONVERSION 


The following table is for hexadecimal-to-decimal and decimal-to-hexadecimal con- 
version. To find the decimal equivalent of a hexadecimal number, locate the hexa- 
decimal number in the correct position and note the decimal equivalent. Add the 
decimal numbers. 

To find the hexadecimal equivalent of a decimal number, locate the next lower 
decimal number in the table and note the hexadecimal number and its position. Sub- 
tract the decimal number from the table from the starting number. Find the dif- 
ference in the table. Continue this process until there is no difference. 


BYTE 

BYTE 

BYTE 

HEX 

DEC 

HEX 

DEC 

HEX 

DEC 

HEX DEC 

HEX DEC 

HEX DEC 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

1,048,576 

1 

65,536 

1 

4,096 

1 

256 

1 

16 

1 

1 

2 

2,097,152 

2 

131,072 

2 

8,192 

2 

512 

2 

32 

2 

2 

3 

3,145,728 

3 

196,608 

3 

12,288 

3 

768 

3 

48 

3 

3 

4 

4,194,304 

4 

262,144 

4 

16,384 

4 

1,024 

4 

64 

4 

4 

5 

5,242,880 

5 

327,680 

5 

20,480 

5 

1,280 

5 

80 

5 

5 

6 

6,291,456 

6 

393,216 

6 

24,576 

6 

1,536 

6 

96 

6 

6 

7 

7,340,032 

7 

458,752 

7 

28,672 

7 

1,792 

7 

112 

7 

7 

8 

8,388,608 

8 

524,288 

8 

32,768 

8 

2,048 

8 

128 

8 

8 

9 

9,437,184 

9 

589,824 

9 

36,864 

9 

2,304 

9 

144 

9 

9 

A 

10,485,760 

A 

655,360 

A 

40,960 

A 

2,560 

A 

160 

A 

10 

B 

11,534,336 

B 

720,896 

B 

45,056 

B 

2,816 

B 

176 

B 

11 

C 

12,582,912 

C 

786,432 

C 

49,152 

C 

3,072 

C 

192 

C 

12 

D 

13,631,488 

D 

851 ,968 

D 

53,248 

D 

3,328 

D 

208 

D 

13 

E 

14,680,064 

E 

917,504 

E 

57,344 

E 

3,584 

E 

224 

E 

14 

F 

15,728,640 

F 

983,040 

F 

61 ,440 

F 

3,840 

F 

240 

F 

15 
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APPENDIX C 
THE EFFECT OF AVAILABLE MEMORY 
ON LINK86, CREF86, LIB86, AND LOC86 


The system resources required by LINK86, CREF86, LIB86, or LOC86 depend on 
the number of symbols, modules, or segments in the input file(s). The greater the 
number of symbols in the input, the greater the memory requirements. 


LINK86, CREF86, AND LIB86 

These utilities can take advantage of up to 512K of available memory space. When 
the number of symbols in the input list requires more memory than is available, 
these utilities use disk resources to accommodate the remainder. Available memory 
means RAM which the utilities have available to them exclusively. Once a utility has 
run out of memory and has to use disk, performance will become impaired. 

The following table defines the number of symbols or modules which these utilities 
may process without performance degradation, given several levels of available 
memory. The available memory depends on the hardware and software environment 
under which the utilities are running on your system. Note that the relationship 
between number of symbols or modules and the amount of available memory is 
linear, up to a maximum. The following assumptions were used to calculate the 
figures provided: 

• Variable and module names average 10 characters. 

• Each symbol has five references (CREF86). 

• Each module has 1 .4 public names (LIB86). 

• A symbol as used here is an abstract representation of an 8086 object module 
format record: 


LINK86 CREF86 LIB86 


Maximum number of symbols or 
modules which can be processed 
without performance penalty; 


With 100K available memory 
With 164K available memory 
With 228K available memory 
With 484K available memory 


1,700 symbols 
2,900 symbols 
4,200 symbols 

10,000 symbols 


1 ,900 symbols 
3,300 symbols 

4,700 symbols 

11,000 symbols 


450 modules 

1 .000 modules 

1 ,700 modules 

4.000 modules 


Theoretical maximum number of 
symbols or modules, regardless of 

available memory; 10,000 symbols 11,000 symbols 


4,000 symbols 


LOC86 

With 96K of available memory, LOC86 will support up to 900 segments. 
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APPENDIX D 
LINK86 CONTROLS 
AND ERROR MESSAGES 


Table D-1 lists all of LINK86’s control syntax, abbreviations, and default settings. 


Table D-1 . Summary of LINK86 Controls 


Control 

Abbrev. 

Default 

fKSS\GH{ivariable(address)y[,...]) 

AS 

Not applicable 

ASSUMEROOT(paf/?name) 

AR 

Not applicable 

BIND 

Bl 

NOBIND 

NOBIND 

NOBI 

COMMENTS 

CM 

COMMENTS 

NOCOMMENTS 

NOCM 

FASTLOAD 

FL 

NOFASTLOAD 

NOFASTLOAD 

NOFL 

INITCODE 

1C 

Not applicable 

LINES 

LI 

LINES 

NOLINES 

NOLI 

MAP 

MA 

MAP 

NOMAP 

NOMA 

M E M POO L(/r7/n-s/ze [ ,maxs/ze ] ) 

MP 

Not applicable 

NAME(moc/u/e name) 

NA 

Not applicable 

OBJECTCONTROLS( 

{LINES 1 NOLINES | 

COMMENTS 1 NOCOMMENTS | 
SYMBOLS 1 NOSYMBOLS 1 
PUBLICS [EXCEPT{sym6o/ [,...])] | 
NOPUBLICS [EXCEPT(sym6o/[,...|)] | 
TYPE 1 NOTYPE | 

PURGE 1 NOPURGE} 

OC 

Not applicable 

ORGE.9.(igroup{isegment[\dass[\ overlay ]]} 
[....])> 

[.-]) 

OD 

Not applicable 

OVERLAy [{overlay)] 

OV 

NOOVERLAY 

NOOVERLAY 

NOOV 

PRINT[(pafrtname)] 

PR 

PRINT(obyecf{/7e.MP1) 

NOPRINT 

NOPR 

PRINTCONTROLS( 

{LINES 1 NOLINES | 

COMMENTS 1 NOCOMMENTS | 
SYMBOLS 1 NOSYMBOLS 1 
PUBLICS [EXCEPT(sym6o/[,...])] 1 
NOPUBLICS [EXCEPT(symtio/ [,...])] | 
TYPE 1 NOTYPE | 

PURGE 1 NOPURGE} [,...]) 

PC 

Not applicable 
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Table D-1 . Summary of LINK86 Controls (Cont’d.) 


Control 

Abbrev. 

Default 

PUBLICS [EXCEPT(sym6o/ [,...|)| 

PL [EC] 

PUBLICS 

NOPUBLICS [EXCEPT(symibo/ [,...])] 

NOPL [EC] 


PUBUCSONLYipathnamel...]) 

PO 

Not applicable 

PURGE 

PU 

NOPURGE 

NOPURGE 

NOPU 

NOPURGE 

RENAMEGROUPS({group JO group} [,...]) 

RG 

Not applicable 

SEGSIZE( 

<.segment[\class[\overlay]] 
{m in-size [ , [max- s/ze ] ] ) } 

[,-]) 

SS 

Not applicable 

SYMBOLS 

SB 

SYMBOLS 

NOSYMBOLS 

NOSB 


SYMBOLCOLUMNS({1 | 2 | 3 | 4>) 

SC 

SYMBOLCOLUMNS(2) 

TYPE 

TY 

TYPE 

NOTYPE 

NOTY 



The following are descriptions of all L1NK86 error and warning messages. The 
description of each message has up to four parts: 

• Meaning— how to interpret the message 

• Cause — the usual reason for the error or v/arning condition 

• Effect — the state of L1NK86 and the object file(s) after the message is issued 

• User Action — what you can do to correct the condition 


Not all these parts are given for each message. However, parts excluded are self- 
explanatory. 


Error messages are always fatal, but warning messages are not. In the event of a 
warning, read the EFFECT of the warning carefully to determine whether the 
resulting code is valid. 

Error and warning messages are displayed at the console device, but printed only if a 
listing would otherwise be printed. 


ERROR 1 : I/O ERROR 

operating system error message 
FILE: pathname 
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ERROR 2: I/O ERROR 

operating system error message 
FILE: pathname 
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ERROR 3: I/O ERROR 

operating system error message 
FILE: pathname 


ERROR 4: CONSOLE I/O ERROR 

operating system error message 
FILE: pathname 

Meaning 

An I/O error was; detected by the operating s;ystem. The error number identifies the 
file that caused the error: 

1. The input file 

2. The print file 

3. The object file 

4. The console file (usually the console) 

Refer to the documentation for your operating system for a complete list of all 
possible messages. 

Effect 

LINK 86 immediately terminates processing, all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Correct the error and restart LINK86. 


ERROR 5: INPUT PHASE ERROR 

FILE: pathname 
MODULE: module name 

Meaning 

LINK86 encountered a record during the second phase of linkage that does not agree 
with information gathered during the first phase of linkage. 

Cause 

This error is caused by a data transmission error or a L1NK86 error. 

Effect 

LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 

User Action 

Contact Intel immediately. Forward a copy of the object file, the LINK86 invoca- 
tion line, and your version of LINK86. 
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ERROR 6: CHECK SUM ERROR 

FILE: pathname 
MODULE: module name 

Meaning 

The check sum field at the end of one of the object module records indicates a 
transcription error. 

Cause 

Any one of many possible data encoding or communication errors could be at fault. 

Effect 

LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 

User Action 

Retranslate the source that produced the specified module and relink. 


ERROR 7: COMMAND INPUT ERROR 

Meaning 

LINK86 encountered an error while attempting to read the complete invocation line. 
Cause 

Possibly an end-of-file while reading from the console input device. 

Effect 

LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 

User Action 

Examine the invocation line, and reinvoke LINK86 correctly. 
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WARNING 8: SEGMENT COMBINATION ERROR 

FILE: pathname 
MODULE: module name 
SEGMENT : segment name 
CLASS: class name 

Meaning 

Two segments with the same name have been found to be uncombinable. 

Cause 

The specified segments have different combination attributes or incompatible align- 
ment attributes. 

Effect 

Although LINK86 will continue processing pass 1, pass 2 will not be started. The 
object file will be useless and the print file will contain limited information. 

User Action 

Retranslate the source that produced the specified file and module. 


WARNING 9: TYPE MISMATCH 

FILE: pathname 
MODULE: module name 
SYMBOL: symbol name 

Meaning 

LINK86 has found a public/external symbol pair for which the type definitions do 
not agree. 

Effect 

L1NK86 continues processing using the first definition only. The object file and the 
print file should be valid, except the second definition is ignored. 

User Action 

Modify the public or external declaration and recompile and relink the source file. 
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WARNING 10: DIFFERENT VALUES FOR 

FILE: pathname 
MODULE: module name 
SYMBOL: symbol name 

Meaning 

LINK86 encountered the same symbol declared public in two different modules. The 
specified file and module contains the second definition encountered. 

Cause 

Two modules have used the same symbol name for different public definitions. 

Effect 

LINK86 continues processing using the value of the first public definition; the 
second definition is ignored. Both the print file and the object file will be valid. 

User Action 

Change the name of the symbol in either the specified file or the file containing the 
earlier definition. 


ERROR 11 : INSUFFICIENT MEMORY 

FILE: pathname 
MODULE: module name 

Meaning 

There is insufficient memory in your system for LINK86 to build its internal tables 
and data structures. 

Cause 

You are using too many public symbols. 

Effect 

LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 

User Action 

If expanding system memory is not possible, try incremental linkage (i.e., link 
smaller sets of files together using the NOPUBLICS control, then link the resulting 
composite modules together). 
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WARNING 12: UNRESOLVED SYMBOLS 

FILE: pathname 
MODULE: module name 

Meaning 

There are declarations of external symbols that were not resolved during this 
linkage. 

Cause 

This is very common when performing an incremental linkage. 

Effect 

The print file is valid. The object file must be linked to resolve the external 
references. 

User Action 

Ldnk object file to a file that will resolve the external references. 


WARNING 13: IMPROPER FIXUP 

FILE: pathname 
MODULE: module name 

Cause 

The external reference makes assumptions about the segment register that do not 
agree with the assumption made for the public definition. 

Effect 

LINK86 continues processing. The object file will not be usable, but the print file 
will be complete and accurate. 

User Action 

Depending on the cause of the error: change your ORDER control, recompile with a 
different model of segmentation, or change the source and reassemble. 
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WARNING 14: GROUP ENLARGED 

FILE: pathname 
GROUP: group name 
MODULE: module name 

Meaning 

The specified group name has been defined twice in two different modules. The 
segments contained in the two definitions are different. 

Effect 

The two groups are combined into one. All segments that were in either group are 
included in the resulting group. Segments with the same segment name, class name, 
and overlay name are combined. L1NK86 continues processing. Both the print file 
and object file are valid. 

User Action 

No user action should be necessary. 


ERROR 15: LINK86 ERROR 

FILE: pathname 
MODULE: module name 

User Action 

Contact Intel immediately. Forward a copy of the object file, the LINK86 invoca- 
tion line, and your version of LINK86. 


ERROR 16: STACK OVERFLOW 

FILE: pathname 
MODULE: module name 

Meaning 

LINK86’s run time stack used for type matching has overflowed. 

Cause 

The type definition of one of your symbols is overly complex. 

Effect 

LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 

User Action 

Try incremental linkage — if error persists, contact Intel. 
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WARNING 17: SEGMENT OVERFLOW 

SEGMENT : segment name 
CLASS: class name 

Meaning 

The combination of two or more segments has resulted in a segment that exceeds 
64K. 

Effect 

LINK86 continues processing during the current pass, but the print and object files 
are not useable. 

User Action 

Reorganize your segments and reassemble. 


WARNING 18: IMPROPER START ADDRESS 

FILE: pathname 
MODULE: module name 

Meaning 

A start address was found in one of the overlay modules, and none was found in the 
root module. 

Cause 

This error is often caused by rnisordering the input modules in the input list. 

Effect 

LINK86 ignores the start address in the specified overlay module and continues 
processing. 

User Action 

If you want the module containing the start address to be the root, relink with that 
module first in the input list. 


ERROR 19: TYPE DESCRIPTION TOO LONG 

FILE: pathname 
MODULE: module name 

Meaning 

The type definition is too long to fit in LINK86’s symbol table. 

Effect 

LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 

User Action 

Contact Intel immediately. Forward a copy of the object file, the L1NK86 invoca- 
tion line, and your version of LINK86. 
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WARNING 20: NO SUCH GROUP 

NAME: group name 

Cause 

You have attempted to rename a nonexistent group. 

Effect 

LINK86 ignores the RENAME control and continues processing. 

User Action 

Reinvoke LINK86 with the correct invocation line. 


WARNING 21 : RENAME ERROR 

NAME: name 

Meaning 

The new group name specified is the same as an existing group. 

Effect 

The group is not renamed. L1NK86 continues as if the rename control was not given. 

User Action 

Reinvoke LINK86 with the correct invocation line. 

ERROR 22: INVALID SYNTAX 

ERROR IN COMMAND TAIL NEAR # 
partial command tail 

Cause 

This is usually the result of a typo in the invocation line. The partial command tail 
up to the point where the error was detected is printed. 

Effect 

LINK86 terminates processing and closes all open files. The contents of the print file 
and the object file are undefined. 

User Action 

Reinvoke LINK86 more carefully this time. 
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ERROR 23: BAD OBJECT FILE 

FILE: pathname 
MODULE: module name 

Meaning 

LINK86 has discovered an inconsistency in the fields of a record in the specified 
input file. 

Cause 

This could be an error by the translator or a data transmission error. 

Effect 

LINK86 immediately terminates proeessing and closes all open files. The contents of 
the print file and the object file are undefined. 

User Action 

Retranslate the source file. If the problem persists contact Intel. 


WARNING 24: CANNOT FIND MODULE 

FILE: pathname 
MODULE: module name 

Meaning 

The specified module cannot be found in the specified library file. 

Effect 

LINK86 continues processing as if the specified module was not in the list. 

User Action 

If the module is important, you can link it into the output object file later. 


WARNING 25: EXTRA START ADDRESS IGNORED 

FILE: pathname 
MODULE: module name 

Meaning 

LINK86 has encountered a start address in more than one module. 

Cause 

This will occur any time you specify more than one main module in the input list. 

Effect 

LINK86 uses the start address encountered earlier and ignores the start address in 
the specified module. LINK86 continues processing with no other side effects. 

User Action 

None, if the start address in the specified module was intended to be ignored. 
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ERROR 26: NOT AN OBJECT FILE 

FILE: pathname 

Meaning 

The specified file is not an object file. 

Cause 

This is usually the result of a typo when entering. However, certain data trans- 
mission errors can also cause this error. 

Effect 

LINK86 terminates processing and closes all open files. 

User Action 

Reinvoke LINK86 typing the line more carefully. If error resulted from a data 
transmission error, retranslate and then relink. 


ERROR 27: OPERATING SYSTEM INTERFACE ERROR 

FILE: pathname 

Effect 

LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 

User Action 

Refer to the documentation for your operating system. If you cannot correct the 
error condition, contact Intel; forward a copy of the object file, the LINK86 invoca- 
tion line, and your version of L1NK86. 


WARNING 28: POSSIBLE OVERLAP 

FILE: pathname 
MODULE: module name 
SEGMENT : segment name 
CLASS: class name 

Meaning 

LINK86 issues this warning when it combines two absolute segments. 

Effect 

L1NK86 continues processing with no side effects. 

User Action 

If there is a conflict LOC86 or the loader will detect the overlap. 
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WARNING 29: GROUP HAS BAD EXTERNAL REFERENCE 

GROUP: group name 
SEGMENT : segment name 

Meaning 

This error occurs if the public symbol corresponding to an external reference has 
been specified by its absolute address, and the address does not reside in any 
segment. 

Effect 

LINK86 continues processing and the print and object files will be valid except the 
external reference has not been properly resolved. 

User Action 

Either remove the reference to the public symbol or do not allow the symbol to be 
absolute. 


ERROR 30: LIBRARY IS NOT ALLOWED WITH PUBLICSONLY CONTROL 

FILE: pathname 

Meaning 

The specified file is a library and libraries are not allowed in a PUBLICSONLY 
control. 

Effect 

LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 

User Action 

Remove library file from PUBLICSONLY argument list and reinvoke LINK86. 


WARNING 31: REFERENCED LOCATION OFFSET UNDERFLOW 

FILE: pathname 
MODULE: module name 

Meaning 

While computing the offset for an 8089 self relative reference, LINK86 had a 
negative result. 

Cause 

Either with the ORDER control or the order of files in the input list, the reference 
was separated from its target, or the 8089 segment is too large. 

Effect 

LINK86 continues processing; however, the invalid offset computation is used. 

User Action 

Examine the ORDER control in the invocation line and modify its arguments. 
Reinvoke LINK86 carefully. 
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WARNING 32: EXTRA REGISTER INITIALIZATION RECORD IGNORED 

FILE: pathname 
MODULE: module name 

Cause 

You have included two main modules in your input list. 

Effect 

LINK86 uses the first register initialization record and ignores the second. Process- 
ing continues. 

User Action 

If the register initialization information in the specified file and module should be 
used, then modify your input list; otherwise, no user action is necessary. 


ERROR 33: ILLEGAL USE OF OVERLAY CONTROL 

FILE: pathname 
MODULE: module name 

Meaning 

LINK86 has found an overlay definition in the specifed file and module, while pro- 
cessing input modules for an overlay. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Remove the specified file from the input list and relink. 


ERROR 34: TOO MANY OVERLAYS IN INPUT FILE 

FILE: pathname 
MODULE: module name 

Meaning 

The specified file and module above contains more than one overlay definition. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Remove the specified file from the input list and relink. 
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ERROR 35: SAME OVERLAY NAME IN TWO OVERLAYS 

FILE: pathname 
MODULE: module name 
NAME: name 

Meaning 

The specified file contains an overlay that has the same name as an overlay 
encountered in the input list. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Remove one of the duplicate names from the input list and relink. If both overlays 
are necessary, relink one overlay specifying a different overlay name. 


ERROR 36: ILLEGAL OVERLAY CONSTRUCTION 

FILE: pathname 
MODULE: module name 

Meaning 

Some of the modules in the input list contain overlay definitions while others do not. 
This is not permitted — all modules in the input list must be the same with respect to 
overlays. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Remove the non-overlay files and relink. 


WARNING 37: DIFFERENT PUBLICS FOR EXTERNAL IN ROOT 

FILE: pathname 
MODULE: module name 

Meaning 

LINK86 has found two symbol definitions in the overlay modules that resolve an 
external symbol definition in the root. 

Effect 

LINK86 ignores the definition in the specified file and module, and continues pro- 
cessing with no side effects. 

User Action 

Remove the unwanted symbol definition and relink. 
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ERROR 38: INVALID OVERLAPPING GROUPS 

FILE: pathname 
MODULE: module name 
SEGMENT : segment name 
GROUP: group name 

Meaning 

While binding the input list LINK86 found a segment that was defined to be within 
two groups. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Either modify the source to remove the segment from one of the groups or do not 
link with the BIND control. 


ERROR 39: SPECIFIED GROUP NOT FOUND IN INPUT MODULE 

GROUP: group name 

Cause 

Often this is the result of a typographical error in the invocation line. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Correct the invocation line and relink. 


ERROR 40: SPECIFIED SEGMENT NOT FOUND IN THE GROUP 

SEGMENT : segment name 
GROUP: group name 

Cause 

Usually this is the result of a typographical error in the ORDER control. 

Effect 

L1NK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Correct the invocation line and relink. 
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ERROR 41: SPECIFIED SEGMENT NOT FOUND IN INPUT MODULE 

SEGMENT : segment name 
CLASS: class name 

Cause 

Usually this is the result of a typographical in the SEGSIZE control. 

Effect 

LINK86 immediately terminates processing; alt open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Find the module that contains the specified segment and add it to the input list. 


WARNING 42: DECREASING SIZE OF SEGMENT 

SEGMENT : segment name 

Meaning 

The size change specified in SEGSIZE has caused LINK86 to decrease the size of the 
specified segment. 

Effect 

Decreasing the size of a segment can cause sections of code to be unaccounted for 
during the memory allocation process. LINK86 continues processing with no side 
effects. 

User Action 

None if the size decrease was intended. 


ERROR 43: SEGMENT SIZE OVERFLOW; OLD SIZE + CHANGE > 64K 

SEGMENT : segment name 
CLASS: class name 

Meaning 

The size change specified in the SEGSIZE control caused the segment to become 
greater than 64K. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Reinvoke LINK86 with the correct SEGSIZE control. 
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ERROR 44: SEGMENT SIZE UNDERFLOW; OLD SIZE + CHANGE < 0 

SEGMENT : segment name 
CLASS: class name 

Meaning 

The size change specified in the SEGSIZE control caused the segment’s size to be 
less than zero. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Reinvoke LINK86 with the correct SEGSIZE control. 


ERROR 45: THE SEGMENT MAXIMUM SIZE IS LESS THAN THE 

SEGMENT MINIMUM SIZE 
SEGMENT : segment name 
CLASS: class name 

Cause 

Usually this is the result of a typographical error in the SEGSIZE control. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Correct the invocation line and relink. 


ERROR 46: ILLEGAL USE OF SEGSIZE CONTROL 

SEGMENT : segment name 
CLASS: class name 

Cause 

A maximum size was specified for either a stack segment, an absolute segment, or a 
segment that is not the highest component of its group. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Remove the specified segment from the SEGSIZE control and relink. 
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WARNING 47: GROUP HAS NO CONSTITUENT SEGMENTS 

GROUP: group name 

Meaning 

The group has no segments and is not placed in the output object file. 

Cause 

Often this is the result of a typographical error in the invocation line. 

Effect 

LINK86 does not place the specified group in the object file and continues process- 
ing with no side effects. 

User Action 

Unless there is some particular need for the specified group, no user action is 
necessary. 


WARNING 48: SIZE OF GROUP EXCEEDS 64K 

GROUP: group name 

Meaning 

All of the segments that belong to the specified group do not fit within the physical 
segment defined for that group. 

Cause 

This error is usually caused by misuse of the SEGSIZE or ORDER controls. 

Effect 

LINK86 includes all segments in the object file and continues processing the input 
module. The output module will be executable, although addressing errors may 
occur. 

User Action 

Examine the invocation line and reinvoke LINK86 using the SEGSIZE or ORDER 
control more carefully. 
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WARNING 49: MAXIMUM SIZE OF GROUP EXCEEDS 64K 

GROUP: group name 

Meaning 

The maximum segment size for the segments contained in the specified group 
exceeds 64K. 

Cause 

This error is usually caused by misuse of the SHGSIZE control. 

Effect 

LINK86 reduces the maximum size of the group and its constituent segments. 
LINK86 continues processing the input module. The output module will be 
executable. 

User Action 

No action is necessary. If you want to remove the error, examine the invocation line 
and reinvoke LINK86 using the SEGSIZE control more carefully. 


WARNING 50: MORE THAN ONE SEGMENT WITH THE MEMORY 

ATTRIBUTE 
SEGMENT : segment name 

Meaning 

After the first memory segment is found, LINK86 issues this warning each time it 
finds a segment with the memory attribute. 

Effect 

LINK86 ignores the memory attribute on the segment specified in the message. 
Processing continues with LINK86 treating the additional memory segment as just 
another segment. 

User Action 

Depending on your intentions, this message may be ignored or you may wish to 
change the segment definition and relink. 


WARNING 51: SEGMENT WITH MEMORY ATTRIBUTE NOT PLACED 

HIGHEST IN MEMORY 
SEGMENT : segment name 

Meaning 

The specified memory segment was not located at the highest offset in its group. 

Cause 

This can only occur when you explicitly request this organization through the 
ORDER control. 

Effect 

Since this can only occur by user request, LINK86 continues processing without side 
effects. 
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WARNING 52: OFFSET FIXUP OVERFLOW 

FILE: pathname 
MODULE: module name 

Meaning 

While computing an offset from a base, LINK86 found that the offset was greater 
than 64K. 

Cause 

One of the segments of a group is outside the 64K frame of reference defined by its 
group base. 

Effect 

LINK86 continues processing. The print file will be valid, but the output file with 
regard to the out of place segment will not be usable. 

User Action 

Modify the group definitions in your source and retranslate. 

WARNING 53: OVERFLOW OF LOW BYTE FIXUP VALUE 

FILE: pathname 
MODULE: module name 

Meaning 

An 8-bit displacement value, when calculated, exceeded 255. 

Cause 

This type of error often occurs when a page resident segment crosses a page 
boundary. 

Effect 

LINK86 continues processing. The contents of both the print file and the object file 
will be valid. However, the fixup value will remain invalid. 

User Action 

Organize your segments so that the addressing error will not be encountered. 

ERROR 54: ILLEGAL USE OF ORDER CONTROL 

GROUP: group name 

Meaning 

The specified group’s segments have already been ordered. 

Cause 

You are attempting to relink a file that has been linked with the BIND control. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Relink using the unbound input modules. 
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ERROR 55: ILLEGAL FIXUP 

FILE: pathname 
MODULE: module name 

Meaning 

While processing a fixup record, LINK86 found that the base for the reference and 
target are different. 

Cause 

This is usually a coding error. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Examine your assembly language source and retranslate. 


ERROR 56: DATA ADDRESS OUTSIDE SEGMENT BOUNDARIES 

FILE: pathname 
MODULE: module name 
SEGMENT : segment name 

Meaning 

One of the data records associated with the specified segment contains an address 
outside of the segment’s boundary. 

Cause 

This error can occur when you decrease the size of a segment. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Change SEGSIZE control and relink. 

ERROR 57: MAXIMUM DYNAMIC STORAGE LESS THAN MINIMUM 

DYNAMIC STORAGE 

Meaning 

The size change specified in MEMPOOL has caused the maximum dynamic storage 
to be less than the minimum dynamic storage. 

Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Reinvoke LINK86 with correct arguments to MEMPOOL. 
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WARNING 58: NO START ADDRESS SPECIFIED IN INPUT MODULES 

Meaning 

The BIND control was specified, and none of the input modules has a start address. 

Cause 

The input list contains no main module. 

Effect 

The CS and IP registers remain uninitialized, and their values are dependent on your 
system loader. The object module will be valid. 

User Action 

Reinvoke LINK86 with a main module or execute LOC86 with the START control. 


ERROR 59: I/O ERROR WITH ROOT-FILE IN ASSUMEROOT CONTROL 

FILE: pathname 
operating system message 

Meaning 

The ASSUMEROOT control was specified, but the root file identified by pathname 
in the invocation could not be accessed. 

Effect 

LINK86 immediately terminates processing. 

User Action 

Refer to your operating system documentation to correct the condition, then rein- 
voke LINK86. 


ERROR 60: OUTPUT FILE IS SAME AS INPUT FILE 

FILE: pathname 

Meaning 

LINK86 detected an output pathname identical to an input pathname. 

Cause 

The pathnames of the specified input file and the output file were identical. 

Effect 

LINK86 terminates processing immediately. 

User Action 

Reinvoke LINK86 after fixing the duplicate-name situation. 
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ERROR 61: ROOT-FILE IN ASSUMEROOT CONTROL IS NOT PROPER 

OBJECT FILE 
FILE: pathname 

Meaning 

The ASSUMEROOT control was specified, but the root file is not found to have an 
overlay record in it. 

Cause 

The root file needs an overlay record. 

Effect 

LINK86 terminates processing immediately. 

User Action 

Relink the root file using the OVERLAY control. 


WARNING 62: ASSUMEROOT CONTROL MEANINGFUL ONLY WITH 

OVERLAYS 

Meaning 

The ASSUMEROOT control should be used only when the input modules do not 
contain overlay records. 

Cause 

ASSUMEROOT was specified, but not in conjunction with the OVERLAY control. 

Effect 

LINK86 ignores the ASSUMEROOT control. The object code is valid. 

User Action 

Reinvoke LINK86, using the OVERLAY and ASSUMEROOT controls. 


WARNING 63: BAD SEGMENT ALIGNMENT 

FILE: pathname 
MODULE: module name 
SEGMENT : segment name 

Meaning 

The segment is not paragraph/page-aligned. 

Cause 

The object code has references to the base of the specified segment, and the segment 
is not declared as paragraph/page-aligned. 

Effect 

Although the object module will be valid, the loader may not load the program 
correctly. 

User Action 

Declare the specified segment to be paragraph/ page-aligned. 
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WARNING 64: PUBLIC SYMBOLS NOT SORTED DUE TO INSUFFICIENT 

MEMORY 


Meaning 

The amount of memory required to sort the public symbols for the LINK86 print file 
listing is insufficient. 

Cause 

The number of public symbols in the input-list modules is too large for LINK86 to 
sort with the available memory resources. 

Effect 

The LINK86 print file listing provides public symbols in the order in which they were 
encountered in the input files. This condition has no effect on the correctness or 
validity of the output module. 

User Action 

Increase the amount of available RAM or decrease the number of public symbols. 


WARNING 65: ILLEGAL FIXUP: INCORRECT DECLARATION OF 

EXTERNAL SYMBOL 

FILE: pathname containing externai deciaration 
MODULE: name of moduie containing externai deciaration 
SYMBOL: name of externai symboi 
FRAME: identification of reference location 
TARGET: iden tifica tion of target ioca tion 

Meaning 

The declaration of the specified SYMBOL was found to be inconsistent with a 
corresponding public symbol definition, and LINK86 could not resolve the 
reference. 

Cause 

This condition may exist for several reasons. The modules containing the external 
and public symbols may have been compiled under different translator controls 
(e.g., SMALL, LARGE). In the case of assembly language programs, the SYMBOL 
may be defined in a group, segment, or frame different from that in which it is 
declared as external. Or an attempt has been made to access absolute entry points 
from pre-located code without using the PUBLICSONLY control explicitly. 

Effect 

LINK86 internally converts these illegal fixups to legal formats to identify all 
occurrences in a single execution. Thus the output object module may not be cor- 
rect, although it will be a valid 8086 object module. 

User Action 

If the warning occurred because of an attempted access of absolute entry points 
from pre-located code, use the PUBLICSONLY control in conjunction with the file 
that contains public definitions for those entry points. Otherwise, use the FRAME 
and TARGET information given in the warning message to pinpoint the source of 
the error, then correct the code. 
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For example; 

WARNING 65: ILLEGAL FIXUP: INCORRECT DECLARATION OF 

EXTERNAL SYMBOL 
FILE: EXTFIL 

MODULE: EXTMODULE 

SYMBOL: EXTSYM 

FRAME: GROUP - GR0UP1 

TARGET: SEGMENT - SEGMENTS 

The symbol EXTSYM is declared to be in SEGMENTS. The external-public resolu- 
tion specified that the calculations be made with respect to the base of GROUP 1, 
but the segment SEGMENTS is not in GROUPl . 


WARNING 66: CS AND IP REGISTERS ARE NOT INITIALIZED 

Meaning 

The INITCODE control was specified, and the register initialization record does not 
contain information for initialization of 8086 registers. CS means code segment 
register, and IP means instruction pointer. 

Cause 

This condition is usually the result of an incomplete END directive in your assembly 
language module or a translation error. 

Effect 

The values of CS and IP at the beginning of program execution are entirely depen- 
dent on the loader of your system. The object code will be valid. 

User Action 

Retranslate your code, then reinvoke LINK86, 


WARNING 67: SS AND SP REGISTERS ARE NOT INITIALIZED 

Meaning 

The INITCODE control was specified, and the register initialization record does not 
contain information for initialization of 8086 registers. SS means stack segment and 
SP means stack pointer. 

Cause 

This condition is usually the result of an incomplete END directive in your assembly 
language module or a translation error. 

Effect 

The values of SS and SP at the beginning of program execution are entirely depen- 
dent on the loader of your system. The object code will be valid. 

User Action 

Correct your code if necessary, then reinvoke LINK86. 
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WARNING 68: DS REGISTER NOT INITIALIZED 

Meaning 

The INITCODE control was specified, and the register initialization record does not 
contain information for initialization of the 8086 DS (data segment) register. 

Cause 

This condition is usually the result of an incomplete END directive in your assembly 
language module or a translation error. 

Effect 

The value of the DS register at program execution is entirely dependent on the loader 
of your system. 

User Action 

Correct your code if necessary, then reinvokc LINK86. 


WARNING 69: OVERLAPPING DATA RECORDS 

Meaning 

The FASTLOAD control was specified, and two data records belonging to the same 
segment have offsets which make them overlapping. 

Cause 

This warning is usually the result of a translation error, unless you have intentionally 
overlapped data records. 

Effect 

LINK86 ignores the second record and does not include it in the output file. The 
code will be unusable. 

User Action 

If you want an overlap condition to exist, reinvoke, but do not use the FASTLOAD 
control. Otherwise, retranslate, then reinvoke LINK86. 


WARNING 70: INITCODE CONTROL INEFFECTIVE WITH BIND 

CONTROL 

Meaning 

The INITCODE and BIND controls were combined in one invocation statement. 

Effect 

The INITCODE control will be ignored by LINK86. 

User Action 

Do not invoke LINK86 using both of these controls at the same time. To invoke 
them separately, use the INITCODE control first, then the BIND control during a 
second invocation. 
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WARNING 71: TOO MANY MAIN MODULES IN INPUT 

FILE: pathname 
MODULE: module name 

Meaning 

LINK86 discovered two or more main modules (modules with start addresses) in the 
input list. 

Cause 

The input list contains too many main modules. 

Effect 

LINK86 uses the start address of the first main module it reads and ignores the 
others. The object code will be valid. 

User Action 

Ensure that the LINK86 interpretation is suitable to your objectives. If not, modify 
the input list, and reinvoke LINK86. 


WARNING 72: REGISTER INITIALIZATION CODE EXISTS, NEW 

INITIALIZATION IGNORED 
FILE: pathname 
MODULE: module name 

Meaning 

Two or more initialization codes for 8086 registers were encountered in the input 
list. 

Cause 

This condition resulted from a translation or linkage problem. 

Effect 

LINK86 uses the first initialization code and ignores the others. The object code will 
be valid. 

User Action 

If retranslating or relinking does not correct the error, contact Intel. 


WARNING 73: INITCODE CONTROL INEFFECTIVE WITH OVERLAYS 

Meaning 

Both INITCODE and OVERLAY controls were specified. 

Effect 

The INITCODE control is ignored. The object code will be valid. 

User Action 

Reinvoke LINK86, using the INITCODE control. In a second invocation, specify 
the OVERLAY control. 
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ERROR 74: PRINT FILE SAME AS INPUT FILE 

FILE: pathname 

Meaning 

The pathnames of the print file and one of the input files are identical. 

Effect 

LINK86 terminates processing immediately. 

User Action 

Reinvoke LINK86 after fixing the duplicate-name situation. 

ERROR 75: PRINT FILE SAME AS OUTPUT FILE 

Meaning 

The names of the print and output files are identical. 

Cause 

The invocation line included duplicate names. 

Effect 

LINK86 terminates processing immediately. 

User Action 

Correct the invocation line and reinvoke LINK86. 


WARNING 76: BASE OF REFERENCED SEGMENT DIFFERS FROM BASE 

OF CONTAINING GROUP 
FILE: pathname 
GROUP: group name 
MODULE: module name 
SEGMENT : segment name 

Meaning 

An assembly language reference to the base of the specified segment in the specified 
group exists. However, the specified segment is not the first segment in the group. 
This warning occurs only when BIND is in effect. 

Cause 

Unless you have deliberately created this reference, this warning is most likely the 
result of an incorrect ASSUME directive or an incorrect OFFSET operator 
specification. 

Effect 

LINK86 will process the specified reference to the segment base rather than to the 
group base. The output module will be valid.. 

User Action 

If the reference to- the segment base was deliberate, continue debugging your 
assembly language code as planned. Otherwise, check the correctness of the code, 
particularly the ASSUME directives and OFFSET operator specifications; then 
reassemble and relink. 
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WARNING 77: REFERENCED OFFSET IN SEGMENT DIFFERS FROM 

OFFSET FROM GROUP BASE 
FILE: pathname 
GROUP: group name 
MODULE: module name 
SEGMENT : segment name 

Meaning 

An assembly language reference to an offset from the base of the specified segment 
in the specified group exists. However, the specified segment is not the first segment 
in the group. This warning occurs only when BIND is in effect. 

Cause 

Unless you have deliberately created this reference, this warning is most likely the 
result of an incorrect ASSUME directive or an incorrect OFFSET operator 
specification. 

Effect 

LINK86 will process the specified reference as an offset from the segment base 
rather than the group base. The output module will be valid. 

User Action 

If the reference to the offset in the segment was deliberate, continue debugging your 
assembly language code as planned. Otherwise, check the correctness of the code, 
particularly the ASSUME directives and OFFSET operator specifications; then 
reassemble and relink. 
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CREF86 CONTROLS 
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Table E-1 lists all of CREF86’s control syntax, abbreviations, and default settings. 


Table E-1 . Summary of CREF86 Controls 


Control 

Abbrev. 

Default 

PAGELENGTH(numPe/) 

PL 

PAGELENGTH(60) 

PAGEWlDTH(numPer) 

PW 

PAGEW1DTH(120) 

PRINT (pathname) 

PR 

PRINT (first input file .CRF) 

J\TLE(character-string ) 

TT 

Not applicable 


The following are descriptions of all CREF86 error and warning messages. The 
description of each message has up to four parts: 

• Meaning— how to interpret the message 

• Cause — the usual reason for the error or warning condition 

• Effect — the state of CREF86 and the object file(s) after the message is issued 

• User Action — what you can do to correct the condition 


Not all these parts are given for each message. However, parts excluded are self- 
explanatory. 


Error messages are always fatal, but warning messages are not. 


Error and warning messages are displayed at the console device, but printed only if a 
listing would otherwise be printed. 


ERROR 1 : I/O ERROR 

operating system message explaining the cause of this erorr 
FILE: pathname 

Meaning 

An I/O error was detected. See the appropriate operating system documentation for 
interpretation. 

Effect 

CREF86 immediately terminates processing; all open files are closed. The contents 
of the print file are undefined. 

User Action 

Correct the error and restart CREF86. 
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ERROR 2: SYNTAX ERROR IN INPUT COMMAND 

Meaning 

An error in the syntax of the invocation line was detected. 

Cause 

This condition is usually the result of a typographical error or transposition. 

Effect 

The invocation command line, to the point it is parsed, is written to the console with 
a # following this string. 

User Action 

Correct the syntactic error and retransmit the invocation line(s). 


ERROR 3: OUT OF MEMORY 

Meaning 

CREF86 does not have enough memory to create its internal data structures, tables, 
etc. This condition may also occur because of inadequate disk space for temporary 
files. 

Cause 

The input list contains too many symbols and/or too many references among them. 

Effect 

CREF86 immediately terminates processing, closing all open files. The contents of 
the print file are undefined. 

User Action 

Ensure that adequate resources are available to run CREF86. 


ERROR 4: I/O ERROR 

operating system error message 
FILE: pathname 

Meaning 

An I/O error was detected. See the appropriate operating system documentation for 
interpretation. 

Effect 

CREF86 processing is immediately terminated. 

User Action 

Correct the error and restart CREF86. 
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ERROR 5: IMPROPER OBJECT MODULE 

FILE: pathname 
MODULE: module name 

Meaning 

The specified module does not meet 8086 object module requirements. 

Cause 

This condition may be caused by the translator or by an error in data transmission. 

Effect 

CREF86 processing is immediately terminated. 

User Action 

Try retranslating the source file. If the problem persists, call Intel. 


ERROR 6: PREMATURE EOF 

FILE: pathname 

Meaning 

CREF86 expects more input data, but encounters an end-of-file (EOF) condition. 

Cause 

This condition usually results from a translator error. 

Effect 

CREF86 processing is immediately terminated. 

User Action 

Return to the previous step in program development, then retranslate or relink. 


ERROR 7: LIBRARY SEEK ERROR 

FILE: pathname 
MODULE: module name 

Meaning 

CREF86 did not encounter a proper library record when scanning a library file. 

Cause 

The library file or the disk may be corrupted. 

Effect 

CREF86 immediately terminates processing. 

User Action 

Reinvoke CREF86 after replacing the file or the disk. 
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ERROR 8: LIBRARY IN OVERLAY MODE 

FILE: pathname 

Meaning 

An input list contains object file(s) with an overlay record count greater than zero 
and a library file. 

Cause 

Libraries cannot contain overlay records. CREF86 can process either all modules or 
no modules with overlay records. 

Effect 

CREF86 immediately terminates processing. 

User Action 

Reinvoke CREF86 using a valid input list. 


ERROR 9: IMPROPER MODULE SEQUENCE 

FILE: pathname 
MODULE: module name 

Meaning 

A combination of modules containing overlay records with those containing 
nonoverlay records was encountered in the input list. 

Cause 

CREF86 can process input lists consisting of either all modules with overlay records 
or no modules with overlay records. 

Effect 

CREF86 immediately terminates processing. 

User Action 

Reinvoke CREF86 with a valid input list. 
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ERROR 10: MORE THAN 255 OVERLAYS NOT SUPPORTED 

Meaning 

The input list contains over 255 files with overlay records. 

Cause 

CREF86 does not support more than 255 overlay files. In the case of input lists 
without overlays, however, there is no limit (except available memory) on the 
number of files CREF86 can process. 

Effect 

CREF86 immediately terminates processing. 

User Action 

Reinvoke CREF86 using fewer than 255 overlay files. 


ERROR 11 : TOO MANY OVERLAYS 

FILE: pathname 
MODULE: module name 

Meaning 

The input file contains more than one overlay. 

Cause 

CREF86 can support files with only one overlay record each. 

Effect 

CREF86 terminates processing immediately. 

User Action 

Reinvoke CREF86 with an input list containing files with no more than one overlay 
each. 
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ERROR 12: I/O ERROR 

operating system error message 
FILE: pathname 

Meaning 

An I/O error was detected. See the appropriate operating system documentation for 
interpretation. 

Effect 

CREF86 terminates processing immediately. 

User Action 

Correct the error and restart CREF86. 


ERROR 13: IMPROPER PAGE WIDTH SPECIFICATION 


Meaning 

The PAGEWIDTH control specification includes a number outside the valid 
syntactic range. 


Effect 

CREF86 terminates processing immediately. 


User Action 

Correct the syntax error and reinvoke CREF86. CREF86 accepts a PAGEWIDTH 
number in decimal form from 80 to 132, inclusive, in the following format: 

PAGEWIDTH (num/jer) 
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ERROR 14: IMPROPER PAGE LENGTH SPECIFICATION 

Meaning 

The PAGELENGTH control specification includes a number outside the valid 
syntactic range. 

Effect 

CREF86 terminates processing immediately. 

User Action 

Reinvoke CREF86 using the proper PAGELENGTH syntax. CREF86 accepts a 
PAGELENGTH number in decimal form from 10 through 255, in the following 
format: 

PAGELENGTH (namilper) 


ERROR 15: ILLEGAL LIBRARY FILE 

FILE: pathname 

Meaning 

CREF86 did not encounter a proper library record in the proper location. 

Cause 

The library file or disk may be corrupted. 

Effect 

CREF86 terminates processing immediately. 

User Action 

Reinvoke CREF86 after replacing the file or the disk. 
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ERROR 16: IMPROPER OBJECT FILE 

FILE: pathname 
MODULE: module name 

Meaning 

CREF86 did not encounter an 8086 object module record in the proper location. 

Cause 

The object file may be corrupt or the file may not be an 8086 object file. 

Effect 

CREF86 terminates processing immediately. 

User Action 

Determine whether the integrity of the object file is intact and whether the file is a 
proper input file for CREF86. Reinvoke CREF86 with a valid and usable object file. 


ERROR 17: OUTPUT FILE SAME AS INPUT FILE 

FILE: pathname 
MODULE: module name 

Meaning 

CREF86 detected an output pathname identical to an input pathname. 

Cause 

The invocation line specified two identical pathnames. 

Effect 

CREF86 terminates processing immediately. 

User Action 

Reinvoke CREF86 after fixing the duplicate-name situation. 
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ERROR 18: CREF86 INTERNAL ERROR 

FILE: pathname 
MODULE: module name 

User Action 

Contact Intel immediately. Forward a copy of the object file, the CREF86 invoca- 
tion line, and your version of CREF86. 


WARNING 19: TYPE MISMATCH 

FILE: pathname 
MODULE: module name 
SYMBOL: symbol name 

Meaning 

CREF86 detected a type mismatch between two symbols with the same name. 

Cause 

Two symbols are declared to have identical names but different types, and the 
symbols are not in different overlay modules. 

CREF86 does not check the entire TYPE declaration for any given symbol. For 
example, dimension values for arrays, number of parameters in procedure calls, etc. 
are not compared. Only simple types (e.g., byte, word, structure) are checked. 

Effect 

CREF86 flags the condition in the cross-reference listing. 

User Action 

Ensure that the condition is not damaging to your programming objectives. 
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WARNING 20: SPECIFIED MODULE NOT FOUND 

FILE: pathname 
MODULE: module name 

Meaning 

A module explicitly included in the input list of the invocation is not found by 
CREF86. 

Cause 

The specified module is not part of the file specified by the pathname. 

Effect 

CREF86 continues processing the modules it i.s able to find. 

User Action 

Determine why the module is missing, then reinvoke CREF86. 


ERROR 21: OPERATING SYSTEM INTERFACE ERROR 

operating system error message 

Meaning 

CREF86 cannot open its temporary file. 

Effect 

CREF86 terminates processing immediately. 

User Action 

Refer to the documentation on the operating system to help diagnose any possible 
operating system malfunction. 
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LIB86 COMMANDS 
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The table below shows all of LIB86’s commands. 

Table F-1. Summary of LIB86 Commands 


Command 

Abbrev. 

Description 

ADD ipathname[(module name[, ...])]} 
[,...] JO pathname 

A 

Adds modules to a library 

CREATE pathname 

C 

Creates a library file 

OEIEJE pathname{module name [,...]) 

D 

Deletes modules from a library 
file 

EXIT 

E 

Terminates session with LIB86 

LIST ipathname[(module name [,...])]> 

L 

Lists modules contained in a 

[,...] [TO pathname] [PUBLICS] 

[P] 

library file, and optionally lists 
all publics 


The following are descriptions of all LIB86 error and warning messages. The 
description of each message has up to four parts; 

• Meaning — how to interpret the message 

• Cause— the usual reason for the error or warning condition 

• Effect— the state of L1B86 and the object file(s) after the message is issued 

• User Action — what you can do to correct the condition 

Not all these parts are given for each message. However, parts excluded are self- 
explanatory. 

Error and warning messages are displayed at the console device. 


MODULE NOT FOUND 
MODULE: module name 
FILE: pathname 

Meaning 

The specified module could not be found in the specified library. 

Cause 

There is a typographical error in the command line. 

Effect 

LIB86 ignores the module in the list and continues processing. 

User Action 

No user action is necessary. 
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RIGHT PARENTHESIS EXPECTED 
partial command tail 


LEFT PARENTHESIS EXPECTED 
partial command tail 


INVALID MODULE NAME 
partial command tail 


MODULE NAME TOO LONG 
partial command tail 


INVALID SYNTAX 
partial command tail 


'TO' EXPECTED 
partial command tail 

Meaning 

All of the above errors are syntax errors. For each of the above errors LIB86 issues 
the associated error message and displays the partial command up to the point of the 
error. 

Cause 

There is a typographical error in the command line. 

Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 

User Action 

Examine the command line, make the necessary corrections and reissue the 
command. 
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UNRECOGNIZED COMMAND 
Cause 

You mistyped a command (ADD, CREATE, DELETE, EXIT, or LIST). 

Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 

User Action 

Examine the command line and enter the corrected command. 


INSUFFICIENT MEMORY 
Meaning 

There is not enough memory available to execute the command. 

Cause 

Exceptionally long and complex commands can cause this error. 

Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 

User Action 

Simplify your command line and reexecute. 


COMMAND LINE TOO LONG 
partial command tail 

Meaning 

The length of the LIB86 command you tried to execute exceeded the size limit of the 
system’s command buffer. 

Effect 

LIB86 immediately terminates processing the command, displays this error message 
plus the portion of the command it would accept, then issues the prompt character 
(*). 

User Action 

Simplify your command line and reexecute. 


F-3 



LIB86 Commands and Error Messages 


iAPX 86,88 Family Utilities 


LIB86 ERROR 
Meaning 

LIB86 failed an internal consistency check. 

Effect 

LIB86 immediately terminates processing. The results of previous commands on the 
library being manipulated when this error occurred may have been lost. 

User Action 

Contact Intel. Forward a copy of the libraries and object files used during the 
session in which the error occurred. 


FILE ALREADY EXISTS 
FILE: pathname 

Meaning 

The file specified in the CREATE command already exists. 

Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 

User Action 

Specify a nonexistent file in the CREATE command. 


DUPLICATE SYMBOL IN INPUT 
SYMBOL: symbol name 
MODULE: module name 
FILE: pathname 

Meaning 

The specified public symbol conflicts with a public symbol defined in one of the files 
given earlier in the input list. This error occurs only during the ADD command. 

Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). The library being manipulated returns to the 
state it was in prior to the ADD command that prompted this message. 

User Action 

Correct the ADD command and reinvoke LIB86. 
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NOT A LIBRARY 
FILE: pathname 

Cause 

The file that the command requests LIB86 to DELETE or LIST is not a library file. 

Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 

User Action 

Reissue the command specifying a library file. 


ILLEGAL RECORD FORMAT 
MODULE: module name 
FILE: pathname 

Cause 

This error is usually caused by a transcription error or translation error in some part 
of an object file examined by LIB86. 

Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 

User Action 

Return to the last step in program development, then retranslate, relink, or relocate. 


PREMATURE EOF 
MODULE: module name 
FILE: pathname 

Meaning 

Due to some transcription error or other the specified file has no module end record. 

Cause 

This is usually the result of a transcription error or translator error. 

Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 

User Action 

Return to the last step in program development, then restranslate, relink, or 
relocate. 
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CHECKSUM ERROR 
MODULE: module name 
FILE: pathname 

Meaning 

The specified file has an error in one of its checksum fields. 

Cause 

This is the result of a transcription error. 

Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 

User Action 

Return to the last step in program development, then retranslate, relink, or relocate. 


ATTEMPT TO ADD DUPLICATE MODULE 
MODULE: module name 

Meaning 

A module with the specified module name already exists in the library. 

Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 

User Action 

Remove the duplicate module from the list and reissue the command. 


ATTEMPT TO ADD MODULE CONTAINING OVERLAYS 
MODULE: module name 
FILE: pathname 

Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). All modules in the input list up to the erroneous 
file are added to library. 

User Action 

Reissue the command with all elements in the input list except those that contain 
overlays. 
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PUBLIC SYMBOL ALREADY IN LIBRARY 
SYMBOL: symbol name 
MODULE: input module name 
FILE: input pathname 

Meaning 

The library already contains the public symbol identified in the error message. 

Cause 

This error occurs when a module is added that has a symbol definition already in the 
library. 

Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 

User Action 

Reexecute the command without the file that contains the duplicate symbol. 
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Table G-1 lists all of LOC86’s control syntax, abbreviations, and default settings. 
Table G-1 . Summary of LOC86 Controls 


Control 

Abbrev. 

Default 

ADDRESSES( 

iSEQMEUJS(isegment{\class[\overlay]] 
{addr)y[,...\) 1 

CL/^SSES{iclass{addr)y[,...] \ 
GF{OUPS{igroup{addr)y[,...]) > 

[,-]) 

AD 

(SM| 

CS|GR) 

Not applicable 

BOOTSTRAP 

BS 

Not applicable 

COMMENTS 

CM 

COMMENTS 

NOCOMMENTS 

NOCM 

m\TCODE[{address)\ 

1C 

INITCODE(200H) 

NOINITCODE 

NOIC 

LINES 

LI 

LINES 

NOLINES 

NOLI 

MAP 

MA 

MAP 

NOMAP 

NOMA 

HAME{module name) 

NA 

Not applicable 

OBJECTCONTROLS( 

CLINES 1 NOLINES | 
COMMENTS 1 NOCOMMENTS | 
SYMBOLS 1 NOSYMBOLS | 
PUBLICS 1 NOPUBLICS | 
PURGE 1 NOPURGE} 

OC 

Not applicable 

ORDER( 

•CSEGMENTS({s<?gfmenf[\c/ass[\oi/er/ay)]} 
[,-]) 1 

CLASSES(iclass[(segment [,...])]> [,...])> 
[....]) 

OD 
(SM 1 
CS) 

Not applicable 

PRINT[(pa/A)name)l 

PR 

PRINT(obyect/'/7e.MP2) 

NOPRINT 

NOPR 

PRINTCONTROLS( 

CLINES 1 NOLINES | 
COMMENTS 1 NOCOMMENTS | 
SYMBOLS 1 NOSYMBOLS | 
PUBLICS 1 NOPUBLICS | 
PURGE 1 NOPURGE} [,...]) 

PC 

Not applicable 

PUBLICS 

PL 

PUBLICS 

NOPUBLICS 

MOPL 

PURGE 

PU 

NOPURGE 

NOPURGE 

NOPU 
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Table G-1 . Summary of LOC86 Controls (Cont’d.) 


Control 

Abbrev. 

Default 

RESERWEdaddrlO addry [,...]) 

RS 

Not applicable 

SEGSiZE({sefirmenf[\c/ass[\ov'er/ay]] 

(s/ze)>[,...]) 

ss 

Not applicable 

START({symtoo/ | paragraph, offsety) 

ST 

Not applicable 

SYMBOLS 

SB 

SYMBOLS 

NOSYMBOLS 

NOSB 

SYMBOLCOLUMNS({1 |2|3| 4>) 

SC 

SYMBOLCOLUMNS(2) 


The following are descriptions of all LOC86 error and warning messages. The 
description of each message has up to four parts: 

• Meaning— how to interpret the message 

• Cause— the usual reason for the error or warning condition 

• Effect— the state of LOC86 and the object file(s) after the message is issued 

• User Action — what you can do to correct the condition 

Not all these parts are given for each message. However, parts excluded are self- 
explanatory. 

Error messages are always fatal, but warning messages are not. In the event of a 
warning, read the EFFECT of the warning carefully to determine whether the code 
is valid. 

Error and warning messages are displayed at the console device, but printed only if a 
listing would otherwise be printed. 


ERROR 1 : I/O ERROR: 

operating system error message 

Meaning 

An I/O error was detected. Refer to the documentation for your operating system 
for interpretation. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Correct the error and restart LOC86. 
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ERROR 2: INVALID SYNTAX 

ERROR IN COMMAND TAIL NEAR #: 
partial command tail 

Meaning 

A syntax error was detected in the invocation line. LOC86 repeats the invocation 
line up to the point of the error. 

Cause 

This is usually the result of a typographical error in the invocation line. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Reenter the invocation line more carefully. 


ERROR 3: MISSING INPUT FILE NAME 

ERROR IN COMMAND TAIL NEAR #: 
partial command tail 

Meaning 

LOC86 was unable to find the input file name in the invocation. LOC86 repeats the 
invocation line up to the point of the error. 

Cause 

This is usually the result of a typographical error in the invocation line. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Reinvoke LOC86 more carefully. 
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ERROR 4: INSUFFICIENT MEMORY 

Meaning 

The memory available on your system has been used up by LOC86. 

Cause 

This can be caused by an input module that has a very large number of segments or 
an impossibly long invocation line. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

This may require changing the source file to reduce the number of segments and 
retranslating. 


ERROR 5: BAD RECORD FORMAT 

MODULE: module name 

Meaning 

There is a record in the specified input module that has an incorrect format. 

Cause 

This is usually a transcription error. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Retranslate and relink the input files before attempting to locate the input module 
again. 
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ERROR 6: INVALID KEY WORD 

ERROR IN COMMAND TAIL NEAR #: 
partial command tail 

Meaning 

One of the controls or subcontrols in the invocation line is incorrect. LOC86 repeats 
the invocation line up to the point of the error. 

Cause 

This is usually the result of a typographical error in the invocation line. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Reinvoke LOC86 more correctly. 


ERROR 7: NUMERIC CONSTANT LARGER THAN 20 BITS 

ERROR IN COMMAND TAIL NEAR #: 
partial command tail 

Meaning 

You have specified an address greater than 1,048,575 (OFFFFFH). LOC86 repeats 
the invocation line up to the point of the error. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line and invoke LOC86 with the correct address. 


ERROR 8: NON NUMERIC CHARACTER IN NUMERIC CONSTANT 

ERROR IN COMMAND TAIL NEAR #: 
partial command tail 

Meaning 

This is a type of syntax error. LOC86 repeats the invocation line up to the point of 
the error. 

Cause 

This is usually caused by a typographical error in the invocation line. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Enter the invocation more carefully. 
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ERROR 9: NUMERIC CONSTANT LARGER THAN 16 BITS 

ERROR IN COMMAND TAIL NEAR #: 
partial command tail 

Meaning 

You have specified an offset greater than 65,536 (OFFFFH). LOC86 repeats the 
invocation line up to the point of the error. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Retype the invocation line more carefully. 


ERROR 10: INVALID SEGMENT NAME 

ERROR IN COMMAND TAIL NEAR 
partial command tail 

Meaning 

LOC86 was expecting a segment name when it found a token that does not cor- 
respond to a valid segment name. LOC86 repeats the invocation line up to the point 
of the error. 

Cause 

This is usually the result of a typographical error. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Reinvoke LOC86 more carefully. 
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ERROR 11 : INVALID CLASS NAME 

ERROR IN COMMAND TAIL NEAR #: 
partial command tail 

Meaning 

LOC86 was expecting a class name when it found a token that does not correspond 
to a valid class name. LOC86 repeats the invocation line up to the point of the error. 

Cause 

This is usually the result of a typographical error. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Reinvoke LOC86 more carefully. 


ERROR 12: INVALID INPUT MODULE 

MODULE: module name 

Meaning 

The input module is invalid. It could mean that object module records are out of 
order, or LOC86 has found an invalid field within a record, or a required record is 
missing. 

Cause 

This is usually caused by a translator error or an attempt to locate something other 
than an object file (e.g., a source file). 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Retranslate source and relink, then try to locate again. If this error continues contact 
Intel. 
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WARNING 13: MORE THAN ONE SEGMENT WITH THE MEMORY 

ATTRIBUTE 
SEGMENT : segment name 

Meaning 

After the first memory segment is found, LOC86 issues this warning each time it 
finds a segment with the memory attribute. 

Effect 

LOC86 ignores the memory attribute on the segment specified in the message. Pro- 
cessing continues with LOC86 treating the additional memory segment as just 
another segment. 

User Action 

Depending on your intentions, this message may be ignored or you may wish to 
change the attribute for the segments and relink them. 


WARNING 14: GROUP DEFINED BY AN EXTERNAL REFERENCE 

NAME: external name 
GROUP: group name 


Meaning 

The specified group is defined by an external reference. This is a type of unresolved 
external reference. 

Effect 

LOC86 continues processing without side effects. 

User Action 

Find the module that defines the specified symbol and relink the input module. 


WARNING 15: PUBLIC SYMBOL NOT ADDRESSABLE 

NAME: public symbol name 

Meaning 

The specified symbol is more than 64K from its base. This error occurs when the seg- 
ment containing the public symbol is not completely contained within the 64K 
physical segment defined by the symbol’s base. 

Effect 

LOC86 continues processing. The object file will be executable. However, any 
attempt to access the specified public symbol will not produce the desired results. 
Debug symbols with this attribute will not be added to the object file. 

User Action 

Change the ORDER or ADDRESSES control so that the segment containing the 
public symbol will be within range of the symbol’s base. 
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WARNING 16: LOCAL SYMBOL NOT ADDRESSABLE 

NAME: local symbol name 

Meaning 

The specified symbol is more than 64K from its base. This error occurs when the seg- 
ment containing the local symbol is not completely contained within the 64K 
physical segment defined by the symbol’s base. 

Effect 

LOC86 continues processing. The object file will be executable. However, any 
attempt to access the specified symbol will not produce the desired results. Debug 
symbols with this attribute will not be added to the object file. 

User Action 

Change the ORDER or ADDRESSES control so that the segment containing the 
local symbol will be within range of the symbol’s base. 


WARNING 17: LINE NUMBER NOT ADDRESSABLE 

NAME: line number 

Meaning 

The specified line is more than 64K from its base. This error occurs when the seg- 
ment containing the line number is not completely contained within the 64K physical 
segment defined by the line’s base. 

Effect 

LOC86 continues processing. The object file will be executable. However, any 
attempt to access the specified line number will not produce the desired results. 
Debug symbols with this attribute will not be added to the object file. 

User Action 

Change the ORDER or ADDRESSES control so that the segment containing the line 
number will be within range of the line’s base. 
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WARNING 18: SIZE OF GROUP EXCEEDS 64K 

GROUP: group name 

Meaning 

Some of the segments of the specified group are not contained within the physical 
segment defined by the group’s base. 

Cause 

This error is usually caused by misuse of the ORDER or ADDRESSES control. 

Effect 

LOC86 continues processing the input module. The output module will be 
executable, but addressing errors may result. 

User Action 

Examine the invocation line and reinvoke LOC86 using the ORDER or 
ADDRESSES control more carefully. 

WARNING 19: BOOTSTRAP SPECIFIED FOR MODULE WITHOUT START 

ADDRESS 

Meaning 

You have specified BOOTSTRAP when locating a module that has no start address. 

Effect 

LOC86 continues processing as if no BOOTSTRAP control was specified. 

User Action 

If you wish initialization code in the program, relocate the input module specifying 
both BOOTSTRAP and START. 

ERROR 20: INVALID NAME 

NAME: bad name 

Cause 

This is the result of a typographical error in the NAME control. A valid name is 
composed of up to forty of the following characters in any order; 

• Alphabetic (A, B, C, ..., Z) 

• Numeric (0, 1, 2, ..., 9) 

• Special 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Reinvoke LOC86 more carefully. 
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ERROR 21: SEGMENT REGISTER DEFINED BY SPECIFIED EXTERNAL 

NAME 

NAME: external name 
Meaning 

A segment register or register pair is defined using the specified external symbol 
name. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Relink and relocate your object modules. 


ERROR 22: SEGMENT SIZE OVERFLOW; OLD SIZE + CHANGE > 64K 

SEGMENT : segment name 
CLASS: class name 

Meaning 

The size change specified in the SEGSIZE control caused the segment to become 
greater than 64K. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Look at the segment’s size in the link map and reinvoke LOC86 with the correct 
SEGSIZE control. 


ERROR 23: SEGMENT SIZE UNDERFLOW; OLD SIZE - CHANGE < 0 

SEGMENT : segment name 
CLASS: class name 

Meaning 

The size change specified in the SEGSIZE control caused the segment’s size to be 
less than zero. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Look at the segment’s size in the link map and reinvoke LOC86 with the correct 
SEGSIZE control. 
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ERROR 24: INVALID ADDRESS RANGE 

Meaning 

The arguments to the RESERVE control are invalid. 

Cause 

The usual cause of this error is that the low address is larger than the high address. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line and reinvoke LOC86 correctly. 


ERROR 25: PUBLIC SYMBOL NOT FOUND 

NAME: public symbol name 

Meaning 

The symbol specified in the START control was not found. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Either specify the argument to START with paragraph and offset, or specify an 
existing public symbol. 


WARNING 26: DECREASING SIZE OF SEGMENT 

SEGMENT : segment name 

Meaning 

The size change specified in SEGSIZE has caused LOC86 to decrease the size of the 
specified segment. 

Effect 

Decreasing the size of a segment can cause sections of code to be unaccounted for 
during the locating process. This is only a warning message. LOC86 continues pro- 
cessing with no side effects. 

User Action 

If the size decrease was not intended, examine the SEGSIZE control in the invoca- 
tion line and relocate. 
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ERROR 27: SPECIFIED SEGMENT IS ABSOLUTE 

SEGMENT : segment name 

Meaning 

You attempted to assign an address to an absolute segment. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Reinvoke LOC86 without using absolute segments in the ADDRESSES control. 


WARNING 28: PAGE RESIDENT SEGMENT CROSSES PAGE BOUNDARY 

SEGMENT : segment name 

Cause 

If you have changed the specified segment’s size, it may be too large to fit within a 
256 byte page, or if you have specifed an address for the segment, it may force the 
segment to cross a page boundary. 

Effect 

Since this error can only occur when you have intentionally specified the segment in 
a control, LOC86 ignores the page resident attribute and continues to process the 
module as if no error has occurred. 

User Action 

If you have invoked LOC86 correctly, then the message is only verifying your inten- 
tions — no action is necessary. 
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WARNING 29: OFFSET FIXUP OVERFLOW 

MODULE: module name 
REFERENCED LOCATION: 20-bit address 
FRAME OF REFERENCE: 20-bit address 

Meaning 

While computing an offset from a base (FRAME OF REFERENCE), LOC86 found 
that the REFERENCED LOCATION was more than 64K bytes away from the base. 

Cause 

This error usually occurs as a result of misuse of the ORDER or ADDRESSES 
control. One of the segments of a group is outside the 64K byte physical segment 
defined by its group base. 

Effect 

LOC86 continues processing. The print file will be valid, but the output file with 
regard to the out-of-place segment will not be usable. 

User Action 

Find the symbol that corresponds to the referenced location, and change the 
ORDER or ADDRESSES control. 


WARNING 30: UNRESOLVED EXTERNAL REFERENCE TO NAME 

AT SPECIFIED ADDRESS 
NAME: symbol name 
SEGMENT : segment name 
ADDRESS: 20-bit address 

Meaning 

There is no public definition for the specified public symbol. There is an unresolved 
external reference to that symbol in the specified segment. 

Cause 

You are locating a module that is not completely linked. 

Effect 

LOC86 continues processing with no side effects. The print file will be valid, and 
except for the unresolved references the object file should be executable. 

User Action 

No action is necessary if the unresolved reference is known. Otherwise, you must 
relink and resolve the external reference. 
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WARNING 31: UNRESOLVED EXTERNAL REFERENCE TO NAME NEAR 

SPECIFIED ADDRESS 
NAME; symbol name 
SEGMENT: segment name 
ADDRESS: 20-bit address 

Meaning 

There is no public definition for the specified public symbol. There is an unresolved 
external reference to that symbol in the specified segment. 

Cause 

You are locating a module that has not been completely linked. 

Effect 

LOC86 continues processing with no side effects. The print file will be valid, and 
except for the unresolved references the object file should be executable. 

User Action 

No action is necessary if the unresolved reference is known. Otherwise, you must 
relink to resolve the external reference. 


WARNING 32: OVERFLOW OF LOW BYTE FIXUP VALUE 

MODULE: module name 
REFERENCED LOCATION: 20-bit address 
FRAME OF REFERENCE: 20-bit address 

Meaning 

An 8-bit displacement value, when calculated, exceeded 255. 

Cause 

This type of error often occurs when a page resident segment crosses a page 
boundary. 

Effect 

LOC86 continues processing. The contents of both the print file and the object file 
will be valid. However, the fixup value will remain invalid. 

User Action 

Find the symbol that corresponds to the REFERENCED LOCATION and organize 
your segments so that the addressing error will not be encountered. 
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3V. WKS HQ WHSllllim SEGMENTS 

GROUP: group name 
Meaning 

The group has no segments and is not placed in the output object file. 

Cause 

Often this is the result of a typographical error in the invocation line. However, it 
may be a linking error that has not shown up until now. 

Effect 

LOC86 continues processing with no side effects. 

User Action 

Unless there is some particular need for the specified group, no user action is 
necessary. 

ERROR 34: SPECIFIED CLASS NOT FOUND IN INPUT MODULE 

CLASS: class name 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Find the module that contains the specified class and link it into the module to be 
located. 


ERROR 35: SPECIFIED SEGMENT NOT FOUND IN INPUT MODULE 

SEGMENT: segment name 
CLASS: class name 


Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Find the module that contains the specified segment and link it into the module to be 
located. 
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WARNING 36: SEGMENTS OVERLAP 

SEGMENT : segment name 
SEGMENT : segment name 
LOW OVERLAP ADDRESS: 20-bit address 
HIGH OVERLAP ADDRESS: 20-bit address 

Meaning 

The two segments overlap in the specified address range. 

Cause 

This can be caused by any number of things: mistake in the SEGSIZE control, 
misuse of ADDRESSES, or two absolute segments that overlap. 

Effect 

LOC86 continues processing the input module. The print file is valid, and the object 
file, with the exception of the overlap, should be usable. 

User Action 

If overlap was intended, no action is necessary. Otherwise, depending on the cause 
of the message, it may be necessary to relocate or even modify the source, and 
retranslate, relink, and relocate. 


ERROR 37: INPUT MODULE EXCEEDS 8086 MEMORY 

SEGMENT : segment name 

Meaning 

While attempting to locate the specified segment, LOC86 ran out of available 8086 
address space. 

Cause 

Although it is possible to write a program that uses a full megabyte of memory, this 
error usually results from an error in the arguments to the RESERVE control. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the REiSERVE control. If, in fact, your program requires more than 
1 ,048,576 bytes of memory, try optimizing with ASM86 or use overlays. 
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WARNING 38: SEGMENT WITH MEMORY ATTRIBUTE NOT PLACED 

HIGHEST IN MEMORY 
SEGMENT: segment name 

Meaning 

The specified memory segment was not located at the highest address in memory. 

Cause 

This can only occur when you explicitly request this organization through the 
ORDER or ADDRESSES control, or when you implicitly request it by assigning 
another segment to the top of memory. 

Effect 

Since this can only occur by user request, LOC86 continues processing without side 
effects. 


ERROR 39: NO MEMORY BELOW SEGMENT FOR SPECIFIED SEGMENT 

SEGMENT : segment name 
SEGMENT : segment name 

Meaning 

In the ORDER control you have requested that the first segment be located below 
the second segment. LOC86 found that there is not enough memory to maintain this 
order. 

Cause 

This error can only occur when one of the segments in an ORDER control is 
absolute. The absolute segment is not necessarily either of the segments specified in 
the command. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Modify the order control. 
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WARNING 40: CANNOT MAINTAIN SPECIFIED ORDERING 

SEGMENT: segment name 

Meaning 

LOC86 cannot locate all of the segments in the ORDER control consecutively. 

Cause 

This is usually caused by specifying absolute segments in the ORDER control or by 
specifying the same segments in ORDER and ADDRESSES. The conflict might not 
be immediately obvious. For example, the specified segment may be specified in the 
ORDER control by its segment name and specified in the ADDRESSES control by 
its class name. 

Effect 

LOC86 continues processing. The print and object files are valid. However, the 
requested segment ordering is not maintained. 

User Action 

Carefully examine your invocation line to find the conflict and relocate the input 
module. 


ERROR 41: SPECIFIED CLASS OUT OF ORDER 

CLASS: class name 

Meaning 

The ORDER control and ADDRESSES control for the specified class disagree. 

Cause 

Either you have assigned an address to the specified class or one of its constituent 
segments, or the translator has made one of its constituent segments absolute. In 
either case, the ORDER control cannot be realized. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Modify the ADDRESSES control or modify the ORDER control. 
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ERROR 42: SPECIFIED SEGMENT OUT OF ORDER 

SEGMENT : segment name 

Meaning 

The ORDER control and ADDRESSES control for the specified segment disagree. 

Cause 

Either you have assigned an address to the specified segment or the translator has 
made the segment absolute. In either case, the ORDER control cannot be realized. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Modify the ADDRESSES control or modify the ORDER control. 


ERROR 43: ADDRESS FOR CLASS SPECIFIED MORE THAN ONCE 

CLASS: class name 

Cause 

This is often caused by a typographical error or some other mechanical error while 
entering the invocation line. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line and reinvoke LOC86 correctly. 


ERROR 44: SEGMENT ADDRESS PREVIOUSLY SPECIFIED IN INPUT 

MODULE OR COMMAND LINE 
SEGMENT : segment name 
CLASS: class name 

Cause 

Either the specified segment is absolute or it has been listed twice in the same 
ADDRESSES control. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line. If the translator has made it an absolute segment, 
either use the translator-assigned address or retranslate the segment. 
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ERROR 45: SEGMENT SPECIFIED MORE THAN ONCE IN ORDER 

SEGMENT : segment name 
CLASS: class name 

Cause 

This error can be caused by either of two errors in the invocation line. You have 
simply specified the same segment twice in the ORDER control. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line and ORDER control and reinvoke LOC86. 


ERROR 46: CLASS SPECIFIED MORE THAN ONCE IN ORDER 

CLASS: class name 

Cause 

You have specified the same class more than once in the same ORDER control. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line and reinvoke LOC86 correctly. 


ERROR 47: SPECIFIED SEGMENT NOT IN SPECIFIED CLASS 

SEGMENT : segment name 
CLASS: class name 

Cause 

This error is usually caused by a typographical error in the arguments to an ORDER 
control. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line and reinvoke LOC86 correctly. 
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ERROR 48: INVALID COMMAND LINE 

Meaning 

LOC86 has encountered an end-of-file or an I/O error while reading the invocation 
line. 

Cause 

You probably terminated the invocation line in the middle of a control argument. 
Most likely you forgot to type the ampersand before you typed the carriage return. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line and reinvoke LOC86 correctly. 


WARNING 49: SEGMENT ALIGNMENT NOT COMPATIBLE WITH 

ASSIGNED ADDRESS 
SEGMENT : segment name 

Meaning 

The alignment attribute does not agree with the address specified in the 
ADDRESSES control. 

Effect 

LOC86 ignores the address assignment and treats the segment as any other 
relocatable segment. 

User Action 

If the address that LOC86 assigns is satisfactory, then no action is necessary. Other- 
wise, examine the print file and assign an address that will agree with the alignment 
attribute. 
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ERROR 50: INVALID COMMAND LINE; TOKEN TOO LONG 

ERROR IN COMMAND LINE NEAR #: 
partial command tail 

Meaning 

An invocation line “token” is impossibly long. A token is a series of characters that 
are not broken by a parenthesis, a comma or a blank (space, carriage-return, line- 
feed or tab). Tokens are syntactic units used in invocation line parsing. Depending 
on how it is used, a token can be a control word, a symbol name, a segment name, a 
filename, etc. 

Cause 

This is often the result of a typographical error in the invocation line. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line and reinvoke LOC86 correctly. 


WARNING 51: REFERENCING LOCATION IS OUTSIDE 64K FRAME OF 

REFERENCE 
MODULE: module name 
ADDRESS: 20-bit address 
FRAME OF REFERENCE: 20-bit address 

Meaning 

The address of a self-relative reference lies outside of the 64K frame of reference of 
the jump or call. This error occurs while locating the module containing the self- 
relative instruction. 

Cause 

This error occurs as a result of misuse of the ORDER or ADDRESSES control. 

Effect 

LOC86 continues processing. The print file is valid, but the object file with respect 
to the module containing the self-relative reference is not executable. 

User Action 

Examine the locate map and reinvoke LOC86 modifying your ORDER and 
ADDRESSES control to correct the error. 
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WARNING 52: REFERENCED LOCATION OUTSIDE 64K FRAME OF 

REFERENCE 
MODULE: module name 
REFERENCED LOCATION: 20-bit address 
FRAME OF REFERENCE: 20-bit address 

Meaning 

The target of a self-relative reference lies outside of the 64K frame of reference of 
the jump or call. This error occurs while locating the module containing the target of 
a self-relative instruction. 

Cause 

This error occurs as a result of misuse of the ORDER or ADDRESSES control. 

Effect 

LOC86 continues processing. The print file is valid, but the object file with respect 
to the module containing the self-relative reference is not executable. 

User Action 

Examine the locate map and reinvoke LOC86 modifying your ORDER and 
ADDRESSES control to correct the error. 


WARNING 53: CANNOT ALLOCATE CLASS AT SPECIFIED ADDRESS 

ADDRESS: 20-bit address 
CLASS: class name 

Meaning 

The specified class cannot be located at the address requested. This is the result of a 
conflict with another address assignment, or an absolute segment, or an address less 
than 200H. 

Effect 

LOC86 assigns the class to the nearest address that will not cause conflict. LOC86 
continues processing, and both the print and object file are valid. 

User Action 

If the alternate address suits your purpose, then no action is necessary. Otherwise, 
examine the locate map and modify your invocation line. 
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ERROR 54: DATA ADDRESS OUTSIDE SEGMENT BOUNDARIES 

SEGMENT : segment name 
MODULE: module name 

Meaning 

One of the data records associated with the specified segment contains an address 
outside of the segment’s boundary. 

Cause 

This error can occur when you assign an address or an order to an absolute segment, 
or a size to a segment. Under some circumstances this can be the result of a linkage 
or translation error. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Change the ADDRESSES, ORDER, or SEGSIZE control and relocate. 


WARNING 55: UNDEFINABLE SYMBOL ADDRESS 

SEGMENT : segment name 
MODULE: module name 

Meaning 

A local symbol, line number, or public symbol has been found in the specified seg- 
ment that is addressed relative to the specified group’s base address. However, the 
segment containing the symbol is not within the 64K frame of reference that is 
defined for that group. 

Cause 

This is usually the result of an address assignment error in the invocation line. 

Effect 

LOC86 continues processing with no other side effects. The print file and object files 
are valid. However, you cannot use the symbols contained in the specified segment. 

User Action 

Examine the invocation line and reinvoke LOC86. 
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WARNING 56: SEGMENT IN RESERVE SPACE 

SEGMENT : segment name 

Cause 

Either an absolute segment uses the area reserved in the invocation line or you 
assigned an address to a segment or class that forces the specified segment to be 
located in the reserved area. 

Effect 

The specified segment is located in the reserved area, and LOC86 continues process- 
ing with no other side effects. Both the print file and object file are usable. 

User Action 

If the assigned address is acceptable for the segment, no action is necessary. 


ERROR 57: INVALID GROUP NAME 

ERROR IN COMMAND TAIL NEAR #: 
partial command tail. 

Meaning 

LOC86 was expecting a group name when it found a token that did not correspond 
to a valid group name. LOC86 repeats the invocation line up to the point of the 
error. 

Cause 

This is often caused by a typographical error in the invocation line. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line and reinvoke LOC86 correctly. 


ERROR 58: SPECIFIED GROUP NOT FOUND IN INPUT MODULE 

GROUP: group name 

Cause 

This is often caused by a typographical error in the invocation line. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line to LOC86 and the link map for the input module. 
Reinvoke LOC86 correctly. 
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ERROR 59: GROUP ADDRESS PREVIOUSLY SPECIFIED IN INPUT 

MODULE OR COMMAND LINE 
GROUP; group name 

Cause 

Either you gave a single group an address twice in the same ADDRESSES control or 
the group already had an address (due to a previous locate). 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Examine the invocation line and either use the previously assigned address or assign 
the group one address per ADDRESSES control. 


WARNING 60: REFERENCED LOCATION IS NOT WITHIN 32K OF 

SPECIFIED ADDRESS 
MODULE: module name 
REFERENCED LOCATION: 20-bit address 
FRAME OF REFERENCE: 20-bit address 

Meaning 

An 8089 self-relative reference is not within 32K bytes of its target address. 

Cause 

Either with the ORDER or ADDRESSES control you have separated the reference 
from its target or the 8089 segment is too large. 

Effect 

LOC86 leaves the invalid reference and continues processing with no other side 
effects. Both the print file and the object file will be valid. 

User Action 

Examine the invocation line and reinvoke LOC86 correctly. 


ERROR 61 : OVERLAY ERROR 

Meaning 

An internal LOC86 error has occurred. 

User Action 

Contact Intel immediately. 


G-27 



LOC86 Controls and Error Messages 


iAPX 86,88 Family Utilities 


WARNING 62: CS AND IP REGISTERS NOT INITIALIZED 

Meaning 

This warning occurs when INITCODE is specified and the input register initializa- 
tion record does not specify intialization of the 8086 code segment (CS) register and 
the 8086 instruction pointer (IP) register. 

Cause 

This condition is usually the result of an incomplete END directive in your assembly 
language module or a translation error. 

Effect 

The values of CS and IP at the beginning of program execution are completely 
dependent on the loader of your system. 

User Action 

Invoke LOC86 with the START control if desired. 


WARNING 63: SS AND SP REGISTERS NOT INITIALIZED 

Meaning 

The INITCODE control was specified, but the register initialization record does not 
contain information for initialization of stack segment (SS) and stack pointer (SP) 
records. 

Cause 

This condition is usually the result of an incomplete END directive in your assembly 
language module or a translation error. 

Effect 

The values of SS and SP at the beginning of program execution are entirely depen- 
dent on the loader of your system. 

User Action 

If you will need to use the stack, retranslate your code, then relink and relocate. 
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WARNING 64: DS REGISTER NOT INITIALIZED 

Meaning 

INITCODE was specified, but the data segment (DS) register initialization record is 
incomplete. 

Cause 

This condition is usually the result of an incomplete END directive in your assembly 
language module or a translation error. 

Effect 

The value of the CS register at program execution is entirely dependent on the 
system loader. 

User Action 

Correct your code if necessary, then reinvoke LINK86 and LOC86. 


WARNING 65: SEGMENT ORDER IN ORDER-CONTROL CANNOT BE 

MAINTAINED 
SEGMENT: segment name 

Meaning 

The ADDRESSES and ORDER control specifications for a segment are in conflict 
and/or the segment cannot be allocated space in accordance with the ORDER 
control. 

Effect 

The conflicting segment is allocated space after all other segments in the target 8086 
memory. 

User Action 

If desired, reinvoke LOC86, using the appropriate ADDRESSES and ORDER 
controls. 
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WARNING 66: START ADDRESS NOT SPECIFIED IN OUTPUT MODULE 

Meaning 

The CS (code segment) and IP (instruction pointer) registers are not initialized. 

Cause 

The input module does not have an explicit .start address, and the START control 
was not specified. 

Effect 

The values of these registers upon initial program execution are entirely dependent 
on the loader. 

User Action 

Either reinvoke LOC86 using the START control or relink to include a main 
module. 
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The following are descriptions of all OH86 error and warning messages. The 
description of each message has up to four parts: 

• Meaning — how to interpret the message 

• Cause — the usual reason for the error or warning condition 

• Effect— the state of OH86 and the object file(s) after the message is issued 

• User Action— what you can do to correct the condition 

Not all these parts are given for each message. However, parts excluded are self- 
explanatory. 

Error messages are always fatal, but warning messages are not. In the event of a 
warning, read the EFFECT of the warning carefully to determine whether the 
resulting code is valid. 

Error and warning messages are displayed at the console device. 


pathname, PREMATURE END-OF-FILE ENCOUNTERED 
Meaning 

OH86 has scanned the entire input file without finding the record that signals the 
end of the module. 

Cause 

There is a transcription error in the specified file. 

Effect 

OH86 immediately terminates processing and closes all open files. The contents of 
the output file are undefined. 

User Action 

Return to the last step in the program development process that did not generate this 
error and relocate, relink, or even retranslate. 
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pathname, EXPECTED MODULE HEADER NOT FOUND 
Meaning 

The first record in the input file was not a module header record. 

Cause 

This is usually caused by specifying an input file that does not contain an 8086 object 
module. 

Effect 

OH86 immediately terminates processing and closes all open files. The contents of 
the output file are undefined. 

User Action 

Check the invocation line; if you specified the input file incorrectly, then reinvoke 
OH86 more carefully. Otherwise, return to the last step in the program development 
process and reexecute. 


pathname, ILLEGAL RELOCATION RECORD ENCOUNTERED 
Cause 

This error occurs whenever you specify a non-absolute 8086 object module as the 
input file. 

Effect 

OH86 immediately terminates processing and closes all open files. The contents of 
the output file are undefined. 

User Action 

Locate the object module with LOC86 before reinvoking OH86. 


pathname, INSUFFICIENT MEMORY TO PROCESS DATA RECORD 
Meaning 

There is insufficient memory in your system for OH86 to process your input file. 

Cause 

You are trying to convert a file that is too complex for the available memory in your 
system. 

Effect 

OH86 immediately terminates processing and closes all open files. The contents of 
the output file are undefined. 

User Action 

Expand the memory on your system. 
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pathname, ILLHGAL REGISTER INITIALIZATION RECORD ENCOUNTERED 
Cause 

Your input module contains a register initialization record. 

Effect 

OH86 immediately terminates processing and closes all open files. The contents of 
the output file are undefined. 

User Action 

Relocate with INITCODE in effect. 


pathname, ILLEGAL OVERLAY INFORMATION ENCOUNTERED 
Cause 

You attempted to convert a file containing overlay information. 

Effect 

OH86 immediately terminates processing and closes all open files. The contents of 
the output file are undefined. 

User Action 

If overlays are necessary, create root and overlay in separate files. 
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APPENDIX I 
ADDITIONAL INFORMATION 
FOR INTELLEC® SERIES III USERS 


Environmental Considerations 

The iAPX 86,88 Family utilities run on and can be used to produce code executable 
on the Intellec Series III Microcomputer Development System. Resulting code is also 
compatible with the ICE-86 Emulator and DEBUG-86. 


The following conventions of the Series III operating system (ISIS-II) are 
encountered in running the utilities: 




The utilities must be executed when the Series III is in the 8086 mode. This 
operating mode is activated by entering the RUN command, either in conjunc- 
tion with a utility program invocation or by itself (to enter the “interactive” 
8086 mode): 


RUN :F1 :L0C86 : F3 : MYPROG . LN 


RUN<c r>H 


: F1 : L0C8& 

:F3:MYPR06.LNK<cr 


• The :Fn: portion of the pathname is the Series III directory-name. In this 
configuration, the directory-name is the equivalent of a device name, the device 
on which the filename is located. If the file is located on the system disk (:F0:), 
the directory-name may be omitted from the pathname. 

• Continuation lines are necessary when, a command or invocation will not fit on 
one line. The following example illustrates the line-end conventions to use and 
the continuation characters to expect: 


LINK86 :F3:TEST.0BJ,SMAL L.L|IB, USER. LIB &<cr> 
aiO :F3:TEST.86 B I N D <c 


> 


• The LIB86 utility presents an exception to these prompt conventions. Because 
this program is interactive, it has its own prompts: 


RUN LIB8;6<cr> 


SERIES-III 8086 LIBRARIAN Vx. 

y 

OADD :F1:SEC.LNK, :F1:CSC.LN 
3Q: FI :TAN|. LNK TD TRIG. LIB<cr 

K, &<cr>| 


★ 


The following table defines compatible software version combinations. 



ISIS-II 

ISIS-III(D) 
V1.0 or later 

V4.0 

V4.1 

V4.2 

RUN 



VI. 0 

V1.0 

V1.3 

VI. 2 

V1.3 



V1.1 

VI .1 

or later 


or later 




VI .2 




L1NK86 

— 

V1.0 

V1.0 

V2.0 

V1.0 

V2.0 





or later 


or later 

CREF86 

— 

VI. 0 or later 

LIB86 

— 

VI .0 or later 

LOC86 

- 

V1.0 or later 

OH86 

— 

V1.0 or later 


Change 1 
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Related Publications 

The following manuals may be helpful during various aspects of your work with 
iAPX 86,88 utilities on the Series III: 

• Intellec Series III Microcomputer Development System Product Overview, 
order number 121575 

• iAPX 86,88 User’s Manual, order number 210201 

• Intellec Series III Microcomputer Development System Console Operating 
Instructions, order number 121609 

• Intellec Series III Microcomputer Development System Programmer’s 
Reference Manual, order number 121618 

• PASCAL-86 User’s Guide, order number 121539 

• PL/M-86 User’s Guide, order number 121636 

• ASM86 Language Reference Manual, order number 121703 

• ASM86 Macro Assembler Operator’s Manual, order number 121628 

• 8089 Macro Assembler User’s Guide, order number 9800938 

• FORTRAN-86 User’s Guide, order number 121570 


Program Development Examples 

The following examples are programming problems solved by using one or more of 
the iAPX 86,88 utilities on the Series III to develop code for an 8086-based host. 

Example 1: Preparing to Use DEBUG-86 

There are only two steps to preparing your code for execution: translating the code, 
then linking it with BIND. 

First you must translate your code. Any of the 8086 translators will work. An 
example of one such translation is shown below: 


RUN PLM86 :F6:TEST.SRC DEBUG SMALL<cr> 


Once the program has been translated, you must then link the program with the 
BIND control. LINK86 with BIND produces an LTL module — the loader assigns 
addresses to the LTL modules at load time. This operation can be performed by the 
8086 loader, RUN. The operation and control of both of these programs is given in 
the Intellec Series III Microcomputer Development System Console Operating 
Instructions . 

The invocation line for LINK86 when linking the program shown above might 
appear as follows: 


RUN LINK86 : F6 ; TEST . OB J , :F6:UT 
0: F6:SMALL. LIB TO :F6:TEST.86 B 



In the above example note that all of the symbol information (LINES, SYMBOLS, 
PUBLICS) is left in the output object file. This will aid you while debugging your 
program. DEBUG-86 uses the symbol information to produce diagnostic informa- 
tion on the program. 

This information is also included in the symbol table. Figure I-l shows the print file 
from the invocation above. 
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The libraries specified resolve all of the external references in TEST. OBJ. 

After the above linkage, the program can be executed with the following command 
to the Series III: 


RUN DEBUG : F6 : TEST . 86<c r> 


SERlliS-lll 8U8b LlNKEti, Vx.y 

INPUT FILES: : F6 i TEST . OBJ , : Fo : UTILS .OBJ , : F6 : SMALL . LIB 

OUTPUT FILE: :F6:TEST.86 

CONTROLS SPECIFIED IN INVOCATION COMMAND: 

BIND 

DATE: MM/DD/YY TIME: 


LINK MAP OF MODULE ROOT 


LOGICAL SEGMENTS INCLUDED: 
LENGTH ADDRESS ALIGN SEGMENT 

035 1 H W CODE 

0014H W CONST 

0196H W DATA 

03F8H W STACK 

OOOOH W MEMORY 

OOOOH G ?7SEG 


CLASS 

CODE 

CONST- 

DATA 

STACK 

MEMORY 


INPUT MODULES INCLUDED: 
:F6: TEST. OBJ (ROOT) 

:FO : UTILS. OBJ (UTILITIES) 
: Fb : SMALL. LIB (DU ATTACH) 

: F6 : SMALL. LIB (DQCLOSE) 

: F6 : SMALL. LIB (DQCRE ATE) 


GROUP MAP 


GROUP NAME: COROUP 

OFFSET SEGMENT NAME 
OOOOH CODE 

GROUP NAME: DOROUP 

OFFSET SEGMENT NAME 
OOOOH CONST 
OOIAH DATA 
01AAH STACK 
0SA2H MEMORY 


SYMBOL 

TABLE OF MODULE ROOT 





BASE 

OFFSET 

TYPE 

SYMBOL 

BASE 

OFFSET 

TYPE 

SYMBOL 

0(2) 

0164H 

PUB 

BINDCONTROL 

0(2) 

004AH 

PUB 

BNODEBASE 

0(2) 

0016H 

PUB 

BUFBASE 

0(2) 

0014H 

PUB 

BUFLEN 

0(2) 

004CH 

PUB 

CLASHNODEBASE 

0(2) 

005EH 

PUB 

COCONN 

0(2) 

015HH 

PUB 

COMMENTSCONTROL 

0(2) 

0 1 6FH 

PUB 

CURRENTOVERLAYNU 

-M 

DEFAULTPRTFILENA 

0(2) 

0171H 

PUB 

DEBUOTOGGLE 

0(2) 

00A5H 

PUB 



MODULE 

NAME = 

ROOT 






BASE 

OFFSET 

TYPE 

SYMBOL 

BASE 

OFFSET 

TYPE 

SYMBOL 

G(2) 

05A2H 

SYM 

MEMORY 

G(2) 

OOOOH 

SYM 

COPYRIGHT 

0(2) 

001 4H 

SYM 

BUFLEN 

0(2) 

0016H 

SYM 

BUFBASE 

0(1 ) 

00F7H 

SYM 

ERROR 

0(1 ) 

OOFEH 

SYM 

WARNING 

G(2) 

0018H 

SYM 

LASTNMNODEP 

0(2) 

001AH 

SYM 

FIRSTNMNODEP 

0(2) 

001 CH 

SYM 

LASTSGNODEP 

0(2) 

001EH 

SYM 

FIRSTSGNODEP 

0(2) 

0020H 

SYM 

LASTTDNODEP 

0(2) 

0022H 

SYM 

FIRSTTDNODEP 

G(2) 

0024H 

SYM 

LASTEXNODEP 

0(2) 

0026H 

SYM 

FIRSTEXNODEP 


0(1 ) 

00A8H 

LIN 

14 1 

G(1 ) 

00B3H 

LIN 

143 

G(1 ) 

OOBEH 

LIN 

144 

G(1 ) 

OOCdH 

LIN 

1 45 

G( 1 ) 

OOCFH 

LIN 

146 

G(1 ) 

00D2H 

LIN 

148 

G(1 ) 

OODDH 

LIN 

149 

G(1 ) 

00E7H 

LIN 

150 

G(1 ) 

OOEEH 

LIN 

152 

G(1 ) 

00F5H 

LIN 

153 

REFERENCES TO 

SEGMENT 

BASES EXIST IN 

INPUT MODULES: 




Figure I-l . LINK86 Print File for Bound Object Module 
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Although we do not recommend it, it is possible to execute an absolute object 
module with DEBUG-86. However, the module must be located in free user 
memory. DEBUG-86 uses the address from OFCOOOH to OFFFFFH, and RUN uses 
the address from OOH to 77FFH. All other memory is available. However, if your 
system does not have a full megabyte of memory, there may be other areas that must 
be reserved. You can use the RESERVE control to prevent LOC86 from using these 
areas. 

The following invocation line is an example of how :F6:TEST.86 might be located; 
although :F6;TEST.86 has been bound, programs that are to be located for execu- 
tion on the Series III need not be bound: 


6 UN L0C86 ;F6:TE ST.86 RESERVE(00H TO 77 F F H , 0 F C 000 H &<cr> 
TO OFFFFFMXc 


The print file produced from the above invocation is shown in figure 1-2. 



Figure 1-2. LOC86 Print File for Bound Object Module 
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Example 2: Preparing to Use an ICE-86 System 

Another way to test and debug software is using in-circuit emulation (ICE) system. 
The ICE-86 loader can load only absolute object modules. Therefore, you cannot 
use the output from LINK86 immediately; it must be located too. 

The whole process of preparing a program for ICE-86 execution takes three steps. 
The first two are the same as in Example 1: the program must be translated and 
linked: 


RUN PLM86 ;f^6:ICETST.$RC $MALL<cr> 


RUN LINK86 ; F6 : I C STS T . 0 B J , : F6 : $M A L L . L I B <c r> 


The above example shows a straightforward linkage with no change to the default 
control setting. Note that NOOVERLAY and NOBIND, the defaults, are set. The 
ICE-86 loader has no facility for dealing with overlay modules ereated by using the 
LINK86 OVERLAY control. In this case there are no unresolved external references 
in the object module. If the module did contain unresolved references, it could still 
be executed by the ICE-86 system. However, as with execution under DEBUG-86, 
executing instructions that contain unresolved references will produce undefined 
results. 

Figure 1-3 shows the print file produced during the invocation shown above. 
LINK86 does not produce a symbol table with NOBIND is in effect. 

The last step before ICE-86 execution is transforming the relocatable object module 
into an absolute object module with LOC86. The invocation line shown below 
would produce an object file that could be loaded and executed by the ICE-86 
Emulator: 


RUN L0C86 : F6: ICElrST. LNK<cr> 


SERIES-III 8086 LINKER, 

INPUT FILES: : F6 : 1 CETST . OB J , : F6 : SMALL . LIB 
OUTPUT FILE: : F6 : ICETST . LNK 
CONTROLS SPECIFIED IN INVOCATION COMMAND: 
DATE: MM/DD/YY TIME: 


LINK MAP OF MODULE LOANER 
LOGICAL SEGMENTS INCLUDED: 

LENGTH ADDRESS ALIGN SEGMENT CLASS OVERLAP 


037DH 

w 

CODE 

CODE 

OOOOH 

VI 

CONST 

CONST 

0192H 

w 

DATA 

DATA 

03F8H 

w 

STACK 

STACK 

OOOOH 

w 

MEMORY 

MEMORY 

OOOOH 

G 

77SEG 



INPUT MODULES INCLUDED: 

:F6: I CETST. OBJ (LOANER) 

: F6 : SMALL. LIB (DQATTACH) 

:F6 : SMALL. LIB (DQCLOSE) 

: F6 : SMALL. LIB (DQCREATE) 

: F6 : SMALL.! IB (DQDETACH) 
:F6:SMALL.LIB(DQEXIT) 

: F6 : SMALL .LIB (DQGETSYSTEMID) 
: F6 : SMALL. LIB (DQOPEN) 

: F6 :SMALL .LIB(DQOVERLAY) 

:F6 : SMALL. LIB (DQWRITE) 

: F6 . -SMALL. LIB (SYSTEMS! A CK) 


Figure 1-3. LINK86 Default Print File 
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This invocation line shows LOC86 invoked with the default control setting. Note 
that the INITCODE control is in effect by default. 

The PL/M-86 program ICETST.SRC is ready for execution on an ICE-86 system. 

Examples: Using CREF86 

Figure 1-4 illustrates a CREF86 cross-reference listing for an input list of 15 files, 
one of which contains several modules. The output print file pathname OUT and a 
title for the listing were specified in the controls. Although PAGEWIDTH (PW) and 
PAGELENGTH (PL) specifications were also noted in the controls, the numbers 
specified are the same as those provided by default. 



Figure 1-4. CREF86 Cross-Reference Listing 
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Example 4: Building and Using Library Files 


A library is a file that contains object modules. Libraries allow you to collect 
commonly used pieces of software into one file. The library file can be included in a 
LINK86 invocation, and LINK86 will use the modules to resolve references. 


You can add the output from a translator, LINK86, or LOC86 to a library. The 
modules added may be relocatable or absolute; they can have unresolved references 
or be completely linked. 


Let’s consider the following scenario — we have created six routines (SINE, 
COSINE, TANGENT, COSECANT, SECANT, and COTANGENT). We want to 
create a library file that will allow each routine to be linked to programs separately. 


The first step necessary to create the library is to translate each routine separately. If 
we were to put them in a single source module, the translator would translate them 
into one module with six public symbols. We could add this module to a library, but 
when we tried to link one of the routines into a program, all six would be included. 


Once the routines are translated, LIB86 can be used to create a library file and add 
modules. The LIST command is used to display the contents of the library and the 
publics contained within it. 



:FO:TRIG.LIB 


SIN 

SINE 

COS 

COSINE 


^DD :F1:SEC.LNK, :F1:CSC.LNK 
□ :F1:TAN.LNK TO T R I G . L I B <c r>| 
LIST TRIG. LIB PUBLICS<cr>M 


: F 0 : T R I G . L I B 
SIN 
SINE 
COS 

COSINE 

SEC 

SECANT 

“cosecant 

COT 

COTANGENT 

TAN 

TANGENT 


,EXIT<c r> 
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Example 5: Linking and Locating F^rograms with 
Overlays Using OVERLAY Control 


The easiest way to build an 8086 program that contain overlays is with LINK86’s 
OVERLAY control. Overlay modules built with this control reside in the same file 
as the root. The operating system supplies routines that will load the overlays con- 
structed in this way. See Intellec Series III Microcomputer Development System 
Programmer’s Reference . 


After the program modules that will constitute the root and its overlays are 
translated, each of the overlays and the root must be linked separately. Then the 
root and all of the overlays are linked together. 

The example below shows the first step toward linking overlays — linking all of the 
modules that will constitute each overlay and the root separately: 


|RUN LINK86 0V1 . OB J , 0V1 A . OB J , 0V1|B . OB J 
HOVZANKOVERLAY^^ 

Fj^UNK8^Vy05^V4AT0B^VE|mmVERLTY4Kc^ 


[RUN LINK86 ROOT. OBJ, RQOTA. OB J, R|00TB.0BJ; &<cr> 
QSMALL.LIB 0 V E R LA Y ( ROOT )<c 


Notice that all of the modules, including the root, are linked with the OVERLAY 
and NOBIND controls. The overlay name for the root is not as critical as for the 
overlays, since the overlay name is used when calling the loader. 


Finally, the overlays and root must be linked together. Since any one of the files 
could be the root, LINK86 requires that for the final link the file containing the root 
must be first in the input list. During this final the OVERLAY control is not used: 


RUN LINK86 ROOT.LNK, 0V 1.LNK, OjVZ.LNK, 0V3.LNK, &<cr> 
Q0V4.LNK TO PROG 


In the invocation, the optional BIND control is specified. The resulting object file is 
executable on a Series III. 


Figure 1-5 shows the LINK86 print file listing for the above invocation. 


There is nothing special about the invocation line to LOC86 when locating a file that 
contains overlays or that has been bound: 


^UN L0C86 PROG. 86 RESERV E (OH T|0 77FFH, &<cr> 
QOFCOOOH TO OPFFFFMXcr>HHi|H^H^^^B 


The RESERVE control prevents LOC86 from assigning memory addresses reserved 
for the operating system. Figure 1-6 illustrates the printout from this invocation. 
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SEhlKS-Ill tjOtib LlNKtH, Vx.y 

INPUT f'ILh,S: ROOl.LNK, OV 1 . LNK , OV2.LNK, OV3.LNK, OVN.LNK 
OUTPUT PILE: PROG. 66 

CONTROLS SPECIPIED IN INVOCATION COMMAND: 

BIND 

DATE: MM/DB/YY TIME: 


LINK MAP OF MODULE HOOT 


LOGICAL SEGMENTS INCLUDED: 

LENGTH ADDRESS ALIGN SEGMENT CLASS 


3CE7H G CODE CODE 

ODOOH G CONST CONST 

28A0H G DATA DATA 


OVERLAY 

ROOT 

ROOT 

ROOT 



INPUT MODULES INCLUDED: 
ROOT,LNK(ROOT) 

OV1 ,LNK(PARSE) 
OV2.LNK(ILUDE) 
OV3.LNK(PICILUDE ) 
OVA.LNK(FASTLOAD) 


GROUP MAP 


GROUP NAME: CGROUP 

OFFSET SEGMENT NAME 


OOOOH CODE\CODE\ROOT 
3CE6h CODE\CODE\PASS1 
3CE6H CODE\CODE\P ASS2 



SYMBOL TABLE OF MODULE ROOT 


BASE 

OFFSET 

TYPE 

SYMBOL 

G(2) 

251CH 

PUB 

ACTUAL 

G(2) 

0F22H 

PUB 

BASEFIXUPSEXIST 

G(2) 

0D26H 

PUB 

BNODEID 

G(2) 

0D26H 

PUB 

CLASHNODEID 

G(2) 

OFOOH 

PUB 

COMMENTSCONTROL 

G{2) 

OF1 AH 

PUB 

CURRENTOVERLAYNU 


BASE 

OFFSET 

TYPE 

SYMBOL 

G(2) 

OFODH 

PUB 

ASSUMEROOTCONTRO 

G(2) 

OFOCh 

PUB 

BINDCONTROL 

G(2) 

24EAH 

PUB 

BUFEASE 

G(2) 

OD5AH 

PUB 

COCONN 

G(2) 

OF50H 

PUB 

CURRENTFILNUM 

G(2) 

OFBEH 

PUB 

CURRENTRECINDEX 



OVERLAY 

NAME = 

ROOT 

, MODULE NAME = ROOT 


BASE 

OFFSET 

TYPE 

SYMBOL 

BASE 

G(2) 

4A20H 

SYM 

MEMORY 

G(2) 

G{2) 

ODOOH 

SYM 

LASTNMNODEID 

G(2) 

G(2) 

ODOAH 

SYM 

LASTSGNODEID 

G(2) 

G(2) 

0D08H 

SYM 

LASTIDNODEID 

G(2) 

G(2) 

ODOCH 

SYM 

LASTEXNODEID 

G(2) 

G(2) 

0D10H 

SYM 

LASTGRNODEID 

G(2) 

G(2) 

OD14H 

SYM 

LASTOVNODEID 

G(2) 

G(2) 

OD16H 

SYM 

LASTGNODEID 

G{2) 


OFFSET TYPE SYMBOL 


0002H 

0D02H 

0D06H 

ODOAH 

ODOEH 

0D12H 

OD16H 

0D1AH 


SYM 

SYM 

SYM 

SYM 

SYM 

SYM 

SYM 

SYM 


COPYRIGHT 

FIRSTNMNODEID 

FIRSTSGNODEID 

FIRSTTDNODEID 

FIRSTEXNODEID 

FIRSTGRNODEID 

FIfiSTOVNODEID 

FIRSTBNODEID 


OVERLAY 

NAME = 

ROOT 

, MODULE NAME = LIT 





BASE 

OFFSET 

TYPE 

SYMBOL 

BASE 

OFFSET 

TYPE 

SYMBOL 

G(2 ) 

4A20H 

SYM 

MEMORY 

G(2) 

003CH 

BAS 

SGNODE 

G(2) 

0F56H 

SYM 

LITBASE 

0(2) 

0F58H 

SYM 

LITID 

G(2) 

OF56H 

BAS 

LITNODE 

G ( 2 ) 

0F5AH 

SYM 

FIRSTNODEIDS 

G(2) 

OF64H 

SYM 

FIRSTNODE 

0(2) 

OFBEH 

SYM 

CURRENTRECINDEX 

G(2) 

0F96H 

SYM 

TEMPLATE 

G(2) 

0FB9H 

SYM 

II 

G{ 1 ) 

016EH 

SYM 

GETLIT 

STACK 

0006H 

SYM 

INDEX 

STACK 

0004H 

SYM 

I 

G( 1 ) 

0207H 

SYM 

SGLIT 


Figure 1-5. LINK86 Listing for Program with Overlays 
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SEKIES-III OObb LOCAlth, l/x.y 

INPUT FILE: PROG.bb 
OUTPUT FILE: PHOU 

CONTROLS SPECIFIEU IN INVOCATION COMMAND: 
RESEhVECOH TO 7 7 FFH , OFCOOOH TO OFFFFFH ) 
DATE: MM/DD/YY TIME: 


SYMBOL TABLE OF MODULE ROOT 


lASE 

OFFSET 

TYPE 

SYMBOL 

BASE 

OFFSET 

TYPE 

SYMBOL 


as 1CH 

PUB 

ACTUAL 

103‘tH 

OFODH 

PUB 

ASSUMEROOTCONTRO 

03*IH 

0F22H 

PUB 

BASEFIXUPSEXIST 

lOS^H 

OFOCH 

PUB 

BINDCONTROL 


0D26H 

PUB 

BNODEID 

103'tH 

2t|EAH 

PUB 

BUFBASE 

03HH 

0028H 

PUB 

CLASHNO0EID 

103‘tH 

0D5AH 

PUB 

COCONH 

03‘tH 

OFOOH 

PUB 

COMMENTSCONTROL 

103‘tH 

0F50H 

PUB 

CURRENTFILNUM 

03*tH 

0F1AH 

PUB 

CURRENTOVERLAYNU 

103‘tH 

OFBEH 

PUB 

CURRENTRECINDEX 


-M 


overlay 

= ROOT 

, MODULE = ROOT 





BASE 

OFFSET 

TYPE 

SYMBOL 

BASE 

OFFSET 

TYPE 

SYMBOL 

103‘tH 

4A20H 

SYM 

MEMORY 

1C34H 

0002H 

SYM 

COPYRIGHT 

1 03‘tH 

ODOOH 

SYM 

LASTNMNODEID 

1C34H 

0D02H 

SYM 

FIRSTNMNODEID 

1 OSttll 

UD04H 

SYM 

LASTSGNODEID 

1C34H 

0D06H 

SYM 

FIRSTSGNODEID 

1 03‘tH 

0D08H 

SYM 

LASTT0NODEID 

1C34H 

ODOAH 

SYM 

FIRSTTDNODEID 

1 034H 

ODOCh 

SYM 

LASTEXNODEID 

1C34H 

ODOEH 

SYM 

FIRSTEXNODEID 

1 034H 

0D10H 

SYM 

LASTGRNODEID 

1C34H 

0D12H 

SYM 

FIRSTGRNODEID 

1 034H 

OD14H 

SYM 

LASTOVNO0E1D 

1C34H 

OD16H 

SYM 

FIRSTOVNODEID 

1 034H 

0D18H 

SYM 

LASTBNODEID 

1C34H 

0D1AH 

SYM 

FIRSTBNODEID 

1 034H 

0D1CH 

SYM 

SGNO0EI0 

1C34H 

OD1EH 

SYM 

GRNODEID 



OVERLAY 

= ROOT 

, MODULE = LIT 





BASE 

OFFSET 

TY PE 

SYMBOL 

BASE 

OFFSET 

TYPE 

SYMBOL 

1 034H 

4A20H 

SYM 

MEMORY 

1034H 

003CH 

SYM 

SGNODE 

1 034H 

0F5faH 

SYM 

LITBASE 

1034H 

OF5BH 

SYM 

LITID 

1 034H 

0F56H 

SYM 

LITNODE 

1034H 

OF5Ah 

SYM 

FIRSTNODEIDS 

1 034H 

OFb4h 

SYM 

FIRSTNODE 

1034H 

OFBEH 

SYM 

CURRENTRECINDEX 

1 034H 

OF96H 

SYM 

TEMPLATE 

1034H 

OFB9H 

SYM 

11 

07bOh 

OIOEH 

SYM 

GETLIT 

STACK 

0006H 

SYM 

INDEX 

STACK 

0004H 

SYM 

I 

0760H 

0207H 

SYM 

SOL IT 

u — — 

MEMORi 

MAP Of 

MODULE ROOT 





MODULE 

START ADDRESS PARAGHAPh = 14D6H 

OFFSET 

= OOObn 



SEGMENT 

MAP 







START 

STOP 


LENGTH ALIGN NAME 


CLASS 


OVERLAY 

07b00H 

0B4E6H 

3CE7H M CODE 


CODE 


ROOT 

0B4EBH 

0F9BAH 

44D3H M CODE 


CODE 


PASS1 

OB4E6H 

OEOCEH 

2BE7H M CODE 


CODE 


PASS2 

OB4E8H 

10337H 

4E50H M CODE 


CODE 


PIC_PASS2 


GROUP MAP 


ADDRESS 

GROUP OR SEGMENT NAME 

07800H 

CGROUP 


CODE\CODE\ROOT 


CODE\CODE\PASS1 


C0DE\C0DE\PASS2 


C0DE\C0DE\P1C_PASS2 


CODE\CODE\FASTLOAD 

10340H 

DGROUP 


CONST\CONST\ROOT 


DATA\DATA\ROOT 


STACK\STACK\ 


Figure 1-6 LOC86 Listing for Program with Overlays 
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Example 6: Linking and Locating Programs with Overlays 
Without OVERLAY Control 

It is harder to produce overlay modules without using the OVERLAY control. 
However, sometimes it is necessary to build programs in this way, for example, 
building a program for running under an operating system that does not support 
overlay modules contained in the same file as the root module. 

But regardless of the reason, building overlays in this fashion places an extra burden 
on the programmer. He must do some of the work that would be left to LINK86 
(and LOC86) if he were to use the OVERLAY control. In the following example we 
prepare a root and two overlay modules in separate files. 

First we must compile all modules. Examples of the invocation lines are shown 
below: 


RUN PLM86 :M:0V2.SRC SMALKcN 


In the next step we must link the root module to resolve external symbols with a 
library and to obtain a link map: 


RUN LINK86 ; F1 : R0(^T . OB J , USER . L| B MAP<~ 


We will need the link map for locating purposes. The link map, shown in figure 1-7, 
shows the size of each segment in the root. Since the overlays are self-contained 
except for references to the root, we do not need a link map for them. The PL/M-86 
listing files will show the size of each overlay’s segments, as illustrated in figure 1-8. 

Note that the length of the root’s code segment and OVl’s code segment must fit 
within 64K. This means that the code for the overlays must be in a part of memory 
contiguous with the root (to avoid altering the CS register during execution). OV2’s 
CONST and DATA segments are larger than OVl’s so that the STACK segment 
must be placed to leave room for OV2’s CONST and DATA segments. If the 
overlays share the STACK and MEMORY segments with the root, they must be 
located at the same address. 



Figure 1-7. LINK86 Map for Root File 
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MODULE INFORMATION; 

CODE AREA SIZE 
CONSTANT AREA SIZE 
VARIABLE AREA SIZE 
MAXIMUM STACK SIZE 
918 LINES READ 
0 PROGRAM ERROR(S) 

END OF PL/M-86 COMPILATION 


OV1 ' s 

s e gme nt s i 

i ze info rma t i on 

7531 H 

30001 0 

this 

i s 

the 

0081 H 

1 29D 

this 

i s 

the 

01 81 H 

3 85D 

this 

i s 

the 

0040H 

64 D 

this 

i s 

the 


DATA segmen t 



0V2 ' s 

segment 

size info rma t i on 


MODULE INFORMATION 
CODE AREA SIZE 

1 B9AH 

7066D 

this 

i s 

the 

CODE segment 

CONSTANT AREA SIZE = 

01 01 H 

257D 

this 

i s 

the 

CONST segment 

VARIABLE AREA SIZE = 

0454H 

1 1 080 

this 

i s 

the 

DATA segmen t 

MAXIMUM STACK SIZE = 

0067H 

1 030 

this 

i s 

the 

STACK segment 

918 LINES READ 
0 PROGRAM ERROR(S) 

END OF PL/M-86 COMPILATION 







Figure 1-8. Module Information for Overlays 


After computing the required location for the root’s DGROUP and STACK, we can 
locate the root module. The resulting file will not be executable, but it allows us to 
resolve references to the root’s code and data symbols in the overlays. The following 
LOC86 invocation will leave room for the overlays’ code segments and place the 
DGROUP in the first unused memory location. (In the command line below, the DS 
register is initialized to OFFCEH, and the CS register is initialized to 0.) The STACK 
and MEMORY segments will be located above OV2’s DATA segment: 


RUN L0C86 :F1:R00T.LNK 8<c 

JADDRESSES (GROUPS (CGROUP (OH), Dii ROU P ( 0 F F C E H ) ) , 

9 SEGMENTS (CODE (OH), CDN S T ( 0 F F C E H ) , S T A C K ( 1 0 B 3 4 H ) ) ) &<cr> 

gORDER (SEGMENTS (CODE, CONS T, DAT A, STACK, MEMORY)) &<c 1 

gs E G S I Z E ( S T A C K ( 1 0 0 H ) X c r 


Once the root is located, we can use it to resolve external references in the overlay 
modules. The overlay modules cannot call each other, since only one is resident in 
memory at any time. The link commands are shown below. The NOPUBLICS with 
the EXCEPT control is used to avoid conflicts when we use the located overlays to 
resolve external references in the root: 


^UN LINK86 :F1:0V1. OBJ, PUBLICS )NLY(:F1: R00T) &<cr> 
QNOPUBLICS EXCEPT(0V1 code, 0V1 )ATA)<cr>^HHH|i 


RUN LINK86 : F1 : 0V2 . OB J , PUB LI CS 

)NLY(:F1 : 

ROOT) &<cr>| 

BNOPUBLICS except (0V2C0DE, 0V2 

)ATAXc r> 



The PUBLICSONLY control resolves references to public symbols contained in the 
root. 
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After the overlays have been linked, they must be located. The code and data 
segments must be placed in the memory locations that were reserved when we first 
located the root. In this case the STACK and MEMORY segments must be the same 
for the overlays and the root: 


him iiiiiii'i I I ii\/i' Mil Hi II ' 

3ADDRESSES (GROUPS (CG ROUP (OH) , DGROUP (0 F FCEH) ) , & 

2 SEGMENTS(C0DE(8A9CH) ,CONST(105E0H) , S TAC K (1 0B34H ) ) ) &<cr> 

30 R D E R ( S E G ME N T S ( C 0 D E , C 0 N S T , STAC K , MEMORY ) ) &<cr>— 
aSEGSIZE(STACK(10i0H) )<cr>|^Mi^— 


Mill MM II II Mil I 

aADDRESSES ( GROUPS (CGROUP(OH) , DG ROUP ( 0 F F C E H ) ) , & < 

3 S EGMENTS ( CODE (8A9CH) , CONST (105 EOH) , STACK ( 1 0B34H) ) ) &<cr> 

aORDER(SEGMENTS (CiQDE, CONS T, DAT A, STACK, MEMORY ) ) &<cr>^^^—l 
aSEGSIZE(ST:ACK(100H) )<cr>— 


The CGROUP and DGROUP base address must be specified in order to compute 
offset information. The final base address assigned to DGROUP by LOC86 will be 
rounded up to OFFDOH. 


Once the overlays are located, the root is linked and located into an executable form. 
The PUBLICSONLY control will resolve references to symbols in the overlay 
modules. Other than the addition of this input control, the LTNK86 and LOC86 
command must be identical to those used previously: 


>> 


RUN LINK86 : FI : ROOT .OBJ ,USER.LIB, &<cr> 
PUBLICSONLY (: F1 :0V1 ,: FI :0V2Xcr> 


RUN L0C86 : FI :R00T. LNK &<cr> 

A DD RE SSES(GR0UPSK CGROUP (OH) , DGROUP (OF FCEH) ) , &<cr> 

SEGMENTS (CODE (OH) , CONST (OF FCEH) , STACK (10B34H) ) ) &<cr> 
ORDER(SEGMENTS(CODE, CONST, DAT^, STACK, MEMORY)) &<cr> 
SEGSIZE(ST;ACK(10bH) )<cr> 


The executable forms of the root and its overlay files are contained in :Fl:ROOT, 
:F1 :,OV 1 , and :F1 :OV2. Figure 1-9 shows the resulting layout of memory. 
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Figure 1-9. Memory Organization for Example 6 1216I6-10 
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Example 7: Unking 8089 Programs with 8086 Programs 

The process of linking and locating 8086 programs with 8089 programs that use 8089 
local memory is very similar to creating overlay modules in separate files. 

Let us consider the following example: we have created an 8086 program and two 
8089 program modules. The 8089 programs reference each other’s symbols and 
public symbols in the 8086 program. In addition, one of the 8089 programs must be 
resident in 8089 local memory. 

The first step is to translate the programs. The 8089 program modules must be 
translated separately, since they will be located in different 8089 address spaces. The 
following lines illustrate the invocation lines to the translators: 




TASK2 should be linked and located first for 8089 local memory. This linkage will 
leave unresolved external references, but it is needed to resolve the references in 
TASKl: 


pJ^WcS^^^^SK^^nESERVEnOOOOI^^OFFFFFHKc^ 


The RESERVE control in the locate above is a precaution to avoid exceeding 64K. 

The next step is to link and locate the object modules that will reside in the 8086’s 
address space. The external references to the 8089 program module that is resident in 
8089 local memory are resolved with the PUBLICSONLY control. The invocation 
lines for linking and locating the modules are: 


BRUN LINK86 : F1 : PR0G86 . OB J , &<crf 



ffl8086. LIB, : FI : TASKl .OBJ, 8089. LI 

J, &<c 

7>^H 

BpUBLICSONLY ( : F1 :TASK2) TO :F1:^ 

J6N89. 

LNK<cr>| 


RUN L0C86 : FI :86N89. LNK<cr> 


:F1:86N89 contains an absolute object module that includes PROG86 and TASKl. 
It may be loaded and executed on an 8086-b.ased system. However, the 8089 pro- 
gram to be located in 8089 local memory still has some unresolved external 
references. To resolve those references we must relink with PUBLICSONLY and 
relocate. The invocation lines to LINK86 and LOC86 shown below are identical to 
those used earlier. This is necessary to guarantee that the references resolved earlier 
are not invalidated; 


|RUN LINK86 ; F 1 ; T AS K2 . 06 J , 80 89 . L|I B , & < 

BPUBLICS0NLY(^^ 

Fj^^C8^^^^SK^^nESERVE|m000t^^0FFFFFH^c? 


NOTE 

The example above makes many assumptions about the 8089 and 8086 code 
that it deals with. In most practical situations it is usually necessary to use a 
more complex LINK86 and LOC86 invocation. However, the example 
above illustrates the key linking and locating principles underlying 
ASM86/ASM89 module combination. 
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Invocation Examples 

The following foldout pages contain examples of the iAPX 86,88 Family utility con- 
trols and commands. The examples, all in the “interactive 8086” mode, may be used 
in conjunction with syntax specifications given: 

• In Chapter 2 for LINK86 

• In Chapter 3 for CREF86 

• In Chapter 4 for LIB86 

• In Chapter 5 for LOC86 

When using the directions in these chapters, fold out the page in this appendix con- 
taining examples of the command or control you are interested in. 

The following is a sample Series III OH86 invocation: 


0H86 :F3:D0|NE TO : F3 : F I N I . HEX< 
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SERIES III LINK86 EXAMPLES 


Comments 


Control 


Examples 


This example defines two public symbols, VARONE 
and VARTWO, with absolute addresses 50H and 
2000H, respectively. 

In this example the root file is RTFILE and LIB1 and 
LIB2 are library files. 


This line creates an LTL module. The output object 
file is TEST with no extension. 

This example specifies default to avoid am.biguity. 


LINES is the default, so it need not be specified. 


This MEMPOOL example will increase the minimum 
dynamic memory requirements by 20H bytes, and by 
default the maximum size will increase, if necessary, 
to equal the minimum. 

The minimum dynamic memory requirement is 100H. 
The maximum dynamic memory requirement is 
300H. 


ASSIGN 


LINK86 FILE1, FILE2, FILE3 ASSIG N S<cr> 
9( VARONE (5 OH) , VARTWO (2000 ) ) <cr>flHB| 


ASSUMEROOT 


LINK86 R00T1.0BJ, R00T2.0BJ , LIB1, &<cr> 
9LIB2 to RTFILE OVER LAY<c 


LINK86 0V11.0BJ, 0V12.0BJ, LIB 1, &<cr> 
aLIB2 TO 0V1.0BJ OVER LAY&<cj2HBB 
9 A S S U M E R 0 0 T ( R T F I L E X c r > 


LINK86 0V21.0BJ, OV22.0BJ, LIB l, &<cr> 
aLIB2 TO 0V2.0BJ OVER LAY&<cr>]B^HH 
9ASSUMER00T(RTFILE)<cr>HH|^^^^H 


LINK86 RTFIL E, 0V1 .OBJ , 0V2.0BJ S<cr> 

P R 0 G < c r > 


BIND/NOBIND 


LINK86 TEST. OBJ , USER. LIB BIND PRINT<cr> 


COMMENTS/NOCOMMENTS 

FASTLOAD/NOFASTLOAD 

INITCODE 

LINES/NOLINES 

MAP/NOMAP 


MEMPOOL 



>> 


FASTLO'AD<cr> 


LINK86 :F1:MYPR0G INITCODE<cr> 
LINK86 :F1:RUN.0BJ NOLINES<cr> 


LINK86 :F1:TEST.0BJ LINES<cr> 
LINK86 : F1 :TESTER.OBJ MAP<cr> 
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Comments 

The LINK86 output module will have the name 
specified in parentheses in the control. 


This example removes all debug and public records 
from the object file. 

The EXCEPT in the NOPUBLICS overrides the 
PURGE. 


This use of ORDER specifies the order of segments 
for two groups. 


This example will create an overlay record, and the 
name of the overlay wil be OVERLAY1 . 


First the constituent files must be linked to form 
overlays. 


The print file is :F1 -.TEMPI .MP1 . 


The print file is ;F1;PROG.MP1. 
The print file is :F1:THE.MAP. 


This example removes information about line 
numbers, local symbols, and comments from the 
print file. 

This statement removes all but the segment informa- 
tion and error messages from the print file. 


SERIES III LINK86 EXAMPLES 


Control 


Examples 


[LTNK86 :F1 :T0M.0BJ,SYS.LIB NAME &<cr^ 
KTHIS is a very long MODULEaNAME.Xcr>| 


OBJECTCONTROLS 


LINK86 :F1 :SRC1 .OBJ, :F1 :SRC2.0BJ, &<cr>| 
3: F3: USER. LIB NAME (TEST_5 .3)<c r>| 

r?NK8^^^XINA^USER^B^<c^ 

HSYS. LIB OBJECTCONTROLS(PURGEXcr^ 


ORDER 


OVERLAY/NOOVERLAY 


LINK86 :F3:PASCL1 .OBJ &<cr>| 

S OBJECTCONTROLS (PURGE, NOPUBLICS &<cr>] 

INK8^^6?pSpR^^^pS 8^UB7 &<cr>| 
SMALL. LIB, USER. LIB &<cr>| 
0RDER(DGR0UP(SEG1,SEG2\CLASS1, &<cr>| 
SEG2\CLASS1 \0VERLAY1 ) , &<cr>| 
CGR0UP(CSEG1 , CSEG2, CSEG3) Xcr>| 

3:F1 :0V1 . LNK OVER LAY (OVER LAY 1 Xc 


LINK86 FILE4, FILES, FILE6 TO &<cr>| 
JXX0V2Xf^^ 

[UNK8^I^7Ti^8Ti^^^<c^ 

|:F1 : ROOT. LNK OVERLAY (ROOT Xc r>| 


PRINT/NOPRINT 


[ UNK86 : F1 :R00T. LNK, : F1 :WT. LNK. &<cr>| 

ILINK86 : F1 :PR0G .OBJ TO &<cr>] 

I: FI :TEMP1 .TST PRINT<cr>| 


LINK86 :F1 : PROG . OB J <c r> 


PRINT CONTROLS 


ILINK86 :F1 :PR0G.0BJ , &<cr>| 
lUSERXIBPR^^ <cr>j 

[LINK8^X2^mWb^<c^ 

BBIND PRINTCONTROLS (NOLINES , &<cr>| 
HnOCOMMENTS, N0SYMB0LSXcr>| 


> 

> 


LINK86 :F3:PASCL1 .OBJ &<cr> 
aPRINTCONTROLS(PURGEXcr>H 
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Comments 

Public information concerning only DATA1, DATA2, 
LABELS, and PROC4 is placed in the object file and 
print file. 

All public symbol information will be included in both 
the print file and output file. 

This example will produce a file containing only the 
absolute public symbol records from :F1:8089.LOC. 
The object file will be :F1 :8089.LNK. 

This will resolve the references in ROOT. OBJ to 
absolute public symbols in the separately linked and 
located overlays OV1 and OV2. 

This produces an object file containing no debug or 
public information. 

This confirms that the line and symbol information 
should be kept in the print file. 

This will change the translator-assigned name 
CGROUP to THE@CODE. A subsequent linkage 
would not combine THE@CODE with a group named 
CGROUP. 

This changes the name of the CODE group to 
CGROUP. 

This tells the loader that 15FFH bytes of code is the 
minimum requirement for MEMORY. The new max- 
imum size of MEMORY is 35FFH. 

This increments MEMORY’S minimum size by 1FFH 
(7951 D) bytes. The maximum size of MEMORY is 
equal to the old minimum size plus 3FEH (15902D). 

The local symbol records will be included in the 
object file. 

PURGE is a shorthand for NOSYMBOLS, 
NOCOMMENTS, NOPUBLICS, NOTYPE, and 
NOLINES. 

SYMBOLCOLUMNS has no effect, since BIND was 
not specified. 

The symbol table will be printed on a line printer. 


LIBMOD will retain its type information. 


SERIES III LINK86 EXAMPLES 


Control 

PUBLICS/NOPUBLICS 


Examples 


LINK86 : FI :TEST.0BJ ,USER. LIB &<cr>| 
3N0PUBLICS EXCEPKOATAI , DATA2, &<cr>| 
gLABEL3,PR0C4Xcr>| 


PUBLICSONLY 


[LINK86 : F4:TEMP. OBJ , SMALL. LIB, &<cr>| 
HUSER.LIB PUBLICS<cr>| 

PNK8^UBUCSON^^TT:8089 . L0CXcr>| 


[LINK86 : FI :R00T.0BJ , &<cr>L 
BPUBLICSONLYC: FI :0V1 , : FI :0V2Xcr>| 


PURGE/NOPURGE 


LINK86 : FI : INDEX. OBJ PURGE<cr> 


^INK86 :F3:FINAL.0BJ PRINTCONTROLS &<cr>| 
H(NOPURGEXcr>| 


RENAMEGROUPS 


[LT¥K 8 6' : FT: PI MPRG.OBJ RENAMEGROUPS &<cr>| 
□ (CGROUP TO THEaCODEXcr>| 


1LINK86 : F9:ASMPRG.0BJ &<cr>||H 
IRENAMEGROUPS (CODE TO CGROUPXcr>| 


SEGSIZE 


LINK86 : F7:GEORGE.OBJ , USER. LIB, &<cr^ 
aSYSTEM.LIB BIND S EG S I Z E ( MEMO R Y &<cr>r 
g(1 5FFH,+2000H) ) <cr>| 


ILINK86 : F4:PR0JCT.0BJ , &<cr>| 

Ire ST. LIB S EGSIZE (MEMORY ( + 1 FF,+1 FF) Xcr>| 


SYMBOLS/NOSYMBOLS 


¥INK86 :F1 :TEMP. OBJ , USER. LIB &<cr>] 
BNOSYMBOLS SYMBOLS<cr>| 


LINK86 : F3:TEST. OBJ , USER. LIB PURGE<cr> 


SYMBOLCOLUMNS 


ILINK86 :F1:TEST.0BJ S YMBO LCO LUMNS (1 ) <cr> 


TYPE/NOTYPE 


LINK86 : FI :R00T. LNK, : F1 :0V1 . LNK, &<cr>| 
3:F1 :OV2.LNK,PUBLICSONLY(:F3:8089) &<cr^ 
aSYMBOLCOLUMNS (4) BIND PR I NT ( : LP : Xc r>n^ 

Fl N K86 : FI : LIBMOD. OBJ TYPE<cr^ 
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Comments 


Control 


Examples 


The cross-reference listing will have 35 lines on each 
page. 

The cross-reference listing will be 100 characters 
wide maximum per page. 

The pathname of the print file will be ;F1 iMYFlLE. 


The message in the TITLE control must be placed on 
one line. If the message contains special characters, 
it must be enclosed in single quotes (’). 


PAGELENGTH 

>l! 


>> 

PAGEWIDTH 

>E 


>> 

PRINT 

>E 


>> 

TITLE 

>B 


>> 


>> 


>> 


PAGELENGTH(35Xcr> 


PAGEWIDTH(100Xcr> 


PRINT(:F1 :MYFILEXcr> 


REF86 MYPR0G,HIS 
MYLIB,HISLIB,HER 
CA CROSS-REFERE 
PAGEWIDTH(105Xc 


ERPROG, S 
TIE &<cr> 
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Comments 

Three object files are added to the USER. LIB. 


Three modules from the library LIB. ABC are added 
to:F3;PROJ.TOM. 

This command will produce an empty library file 
called TOMS. LIB. 


Four modules are deleted from the library USER. LIB. 


SERIES III LIB86 EXAMPLES 


Control 


Examples 


[ADD :F1 :SIN, :F1 :C0S, :F1 :TAN TO &<cr>-j 
Q: F0:USER. LIB<cr>| 


[ADD : F1 : LIB. ABC (MODI , M0D2, M0D3) S<cr>] 
DtO :F3:PR0J .T0M<cr>| 


CREATE : F3:T0MS. LIB<C''> 


CREATE :F0:USER. LIB<cr> 


[DELETE :F3:U$ER.LIB(TEMP1 , &<c ->| 
□TEMP3, TEM TMP , T E S T ’ )<i: r >■■ 


DELETE : FO: 10. LIB(FLOPPY, CRT, &<-->] 
QPAPER TAPEXcr>| 


LIST USER. LIB<cr> 


USER. LIB 
TEMP 


LIST USER. LIB(TEMP,TESTXcr> 


USER. LIB 
TEMP 
TEST 


LIST USER. LIB, TEMP. LIB<cr> 


USER. LIB 
TEMP 
TEST 
EXEC 
MAIN 
LOOP 

TEMP. LIB 
M0DULE1 
M0DULE3 
MODULETC 
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Comments 

If SEG1 is byte alignable, it will be located at 15FFH. 
If SEG2 is byte or word alignable, it will beat4F5AH. 


Address assignment of groups, segments, and 
classes can be in any order, unless they are 
absolute. 


A long jump to GO will be placed at location 
OFFFFOH. 


The initialization code is placed at address 32768 
decimal (8000H). 

No initialization code will be produced. 


LINES is the default, so it need not be specified. 


This statement removes all debug records from the 
object file, but keeps the information in the print file. 


NOPUBLICS is implied by PURGE, but PUBLICS 
overrides it. 

SEG@A of CLASS1 will be the first relocatable 
segment located. SEG@B will be next, followed 
immediately by any other segments contained within 
CLASS1. The extra segments in CLASS1 (and all of 
the segments in CLASS2) are located in the order in 
which they are encountered. Finally, the list in the 
SEGMENTS subcontrol is handled. 


SERIES III LOC86 EXAMPLES 


Control 


ADDRESSES 


BOOTSTRAP 


Examples 


L0C86 :F7:C0ME.LNK TO :F8:WENT &<cr>| 
JADDRESSES (SEGMENTS (SEG1 \CLASS2\ S<cr>| 

L0C86 :F8:IST.LNK TO LOCIST.RDY &<cr>| 
3ADDRESSES(SEGMENTS(SEG1 \CLASS1 &<cr>| 
3(23H)), GROUPS(CGROUP(OOH) ,DGR0UP &<cr> 
|(1 0000H))^C^ ) <c r> 

BB00TSTRAP<cr>| 


IN ITCO DE/NOIN ITCODE 


|L0C86 : F1 iSOURCE. LNK N0C0MHENTS <c r>| 
OC8^^^^m^J^Nm0DE(327 6 8 X c r > I 


.INES/NOLINES 


MAP/NOMAP 


NAME 


OBJECTCONTROLS 


ORDER 


F1 :TEST. LNK NOIN ITC0DE <c r>| 

F1 :TESTER. LNK MAP<cr>| 

IL0C86 :F3:G0NE. LNK TO &<cr>| 

ILOCS^^^SHO^^J^JaME &<cr>| 

KTHIS is a _VERY_L 0 NG :MODU LEaNAME . )<c r>j 

L0C86 : F 1 : U 

aOBJECTCONTROLS (NOLINES, &<cr>| 
pOCOMMEf^^ 

pC8^ 

HOB J E CTCONTRO LS (PURGE, PUB Lies )<c r>| 

^C8^^oTsPCSE^Ul^nE^<c^ 
a(CLASSES (CLASSKSEGSA, SEG3B) , &<cr>] 

8c LAS S2) , SEGMENTS (SEG1 \C LAS S3 &<cr>| 
g\0VERLAY1 ,SEG22,SEG10\CLASS5)Xcr> 
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SERIES III LOC86 EXAMPLES 


Comments 


Control 


Examples 


The print file is ;F1:TEMP.MP2. 


The print file is ;F5:INTERPL.MP2. 

The print file is ;F1;MAP. 

Information about line numbers is removed from the 
print file. 

All but the segment information is removed from the 
print file. 

No public information is included in the output files 
(;F7:PRIVAT.MP2and :F7;PRIVAT). 

Ail public symbol information will be included in both 
the print file and output file. 

The object file contains no public or debug informa- 
tion, and the symbol table does not appear in the 
print file. 

The line and symbol information will be kept in the 
print file and object file. 

This control reserves the high order 64K of memory. 


A 200H and a 100H section of memory at the top and 
bottom of memory are reserved. 

The size of segment MEMORY will be increased by 
2000 bytes. 

The size of segment FREUD will be decreased by 
511 bytes. 

The new segment size for XENDA is 7770 bytes. 


;F9:AUTO will start at IGNITION. 

;F7:HALTS will start at location 200H. 

This statement will include the local symbol records 
in the object file and the symbol information in the 
print file. 

PURGE is a shorthand for NOSYMBOLS, 
NOCOMMENTS, NOPUBLICS, and NOLINES. 


The symbol table will be printed on a line printer. A 
line printer line can hold a four-column symbol table. 


PRINT/NOPRINT 

PRINTCONTROLS 

PUBLICS/NOPUBLICS 

PURGE/NOPURGE 

RESERVE 

SEGSIZE 

START 

SYMBOLS/NOSYMBOLS 

SYMBOLCOLUMNS 
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ADDITIONAL INFORMATION 
FOR IRMX™86 USERS 


Environmental Considerations 


The iAPX 86,88 Family utilities run on and can be used to produce code executable 
on the iRMX 86~based systems. Resulting code is also compatible with the ICE-86 
Emulator and the iSBC 957B Interface and Execution Package. 


To run the utilities on an iRMX 86-based system, you must have the following hard- 
ware and software: 


• The iRMX 86 Human Interface (and other iRMX 86 layers necessary to support 
the Human Interface). 


• At least one mass storage device. The installation of the utilities always requires 
a single- or double-density diskette drive, since the product is delivered in 
diskette form. 


• Enough memory to run the utilities (above and beyond that required for the 
Operating System). Table J-1 lists the memory requirements for the individual 
utilities. The minimum required column indicates the minimum amount of 
memory needed to run the utilities, assuming connection to only six files. The 
maximum usable column indicates the largest amount of memory the utilities 
can use. 


Table J-1 . iRMX 86 Memory Requirements 


Utility 

Minimum Required 

Maximum Usable 

LINKB6 

105K 

51 2K 

CREF86 

129K 

51 2K 

LIB86 

128K 

51 2K 

LOC86 

120K 

120K 

OH86 

90K 

90K 


When you run the utilities on an iRMX 86-based system, you must obey the follow- 
ing conventions: 


• To invoke a utility, you must enter the pathname of the file that contains the 
utility. An example of this is: 


:PR0G:L|0C86 : !F DO : PROG D I R /MY P ROG R AM . LN K <cr> 
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• The portion of the pathname delimited with colons (:) is an iRMX 86 logical 
name. A logical name identifies the device that contains the file; in some cases it 
also identifies a portion of the directory tree. In this example, LOC86 resides in 
a directory identified by the logical name :PROG:; MYPROGRAM.LNK 
resides in a subdirectory of a device identified by the logical name :FD0:. If you 
omit the logical name from the command (in this case, LOC86), the Operating 
System automatically searches several directories for the command. The direc- 
tories searched and the order of search are iRMX 86 configuration parameters. 
If you omit the logical name from a file used as a parameter (in this case 
PROGDIR/MYPROGRAM.LNK), the Operating System assumes that the file 
resides in the default directory (:$:). 

• Slashes (/) and up-arrows or circumflexes (A) separate individual components of 
the pathname. A file’s pathname can consist of several components, depending 
on where the file exists in the overall directory tree. To identify a file, you start 
with a logical name (or assume the default), continue through the directory tree 
specifying as many directory names as necessary, and finally specify the name of 
the file with which you are concerned. You use separators between the 
individual components of the pathname (except immediately after the logical 
name). The slash separator tells the Operating System to search down one level 
in the directory tree for the next component. The circumflex separator tells the 
Operating System to search up one level in the directory tree. For example, if 
file TEXTFILE.P86 resides in directory PROGRAMS, and if directory 
PROGRAMS resides on a device identified by logical name :FD1:, you can 
identify the file by specifying the following pathname; 

:FD1 :PROGRAMS/TEXTFILE.P86 

• Continuation lines are necessary when a command or invocation will not fit on 
one line. The following example illustrates the line-end conventions to use and 
the continuation characters to expect: 


[LINK86 :WD1 : PROG /TEST . OB J , : 

fJD1 :PR0G/$MALL. LIB, &<cr>| 

QUSER. LIB TO :WD1 :PR0G/TEST 



• The LIB86 utility presents an exception to these prompt conventions. Because 
this program is interactive, it has its own prompts: 


LIB86<cr> 


iRMX 86 8086 LIBRARIAN Vx.y 


□ADD : FI : 

SEC. 

LNK, 

: F1 : 

CSC. LNKj 

B]: F1 :TAN 

. LNK 

TO 

: PROG 

: LIBRARl 


B<c 


D 


Related Publications 

The following manuals may be helpful during various aspects of your work with the 
iAPX 86, 88 utilities on an iRMX 86-based system; 

• introduction to the iRMX 86 Operating System, order number 9803 1 24 

• iRMX 86 Human Interface Reference Manual, order number 9803202 

• iAPX 86, 88 User's Manual, order number 210201 

• PASCAL-86 User’s Guide, order number 121539 

• PL/M-86 User’s Guide, order number 121636 

• ASM86 Language Reference Manual, order number 1 2 1 703 

• ASM86 Macro Assembler Operating Instructions for 8086- Based Development 
Systems, order number 121628 

• FORTRAN-86 User’s Guide, order number 121510 
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Generating Code to Run on an iRMX 86-Based 
System 

To generate code that runs on an iRMX 86-based system, perform the following 
steps: 

1. Translate the program into object code by using the appropriate compiler or 
assembler. 


2. Use LINK86 to link the program with other routines or libraries as necessary. 
When doing this, remember the following: 

• If you wrote your program in FORTRAN or Pascal, or if you invoked 
specific universal development interface (UDI) calls, you must link your 
program to the iRMX 86 UDI library that corresponds to the model of 
segmentation for your program. These libraries are: 


Library 

URXLRG.LIB 

URXCOM.LIB 

URXSML.LIB 


Model of Segmentation 
LARGE or MEDIUM 
COMPACT 
SMALL 


• Do not use FASTLOAD control. Currently, the iRMX 86 Operating System 
cannot load programs linked with this control. 

• To produce LTL code, use the BIND control. In this case, also specify the 
MEMPOOL and SEGSIZE controls to allocate memory for the memory 
pool and stack. If you do not use BIND, you must specify SEGSIZE with 
the LOC86 command. 


3. If you did not specify the BIND control in the LINK86 command, use LOC86 to 
assign absolute addresses to your program. In order to run this program in an 
iRMX 86 environment, you must also reserve the program’s memory locations 
during iRMX 86 configuration. 


4. To invoke the program from a terminal, enter the pathname of the file that 
contains the program’s linked (if LTL code) or located object code. 


Program Development Examples 


The following examples are programming problems solved by using one or more of 
the iAPX 86,88 utilities on an iRMX 86-based system. 


Example 1: Using CREF86 

Figure J-1 illustrates a CREF86 cross-reference listing for an input list of 15 files, 
one of which contains several modules. The output print file pathname OUT and a 
title for the listing were specified in the controls. Although PAGEWIDTH (PW) and 
PAGELENGTH (PL) specifications were also noted in the controls, the numbers 
specified are the same as those provided by default. 
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Figure J-1 . CREF86 Cross-Reference Listing 


J-4 





iAPX 86,88 Family Utilities 


Additional Information for iRMX 86 Users 


Example 2: Building and Using Library Files 


A library is a file that contains object modules. Libraries allow you to collect 
commonly-used pieces of software into one file. The library file can be included in a 
LINK86 invocation, and LINK86 will use the modules to resolve references. 


You can add the output from a translator, LINK86, or LOC86 to a library. The 
modules added may be relocatable or absolute; they can have unresolved references 
or be completely linked. 


Let’s consider the following scenario — we have created six routines (SINE, 
COSINE, TANGENT, COSECANT, SECANT, and COTANGENT). We want to 
create a library file that will allow each routine to be linked to programs separately. 


The first step necessary to create the library is to translate each routine separately. If 
we were to put them in a single source module, the translator would translate them 
into one module with six public symbols. We could add this module to a library, but 
when we tried to link one of the routines into a program, all six would be included. 


Once the routines are translated, LIB86 can be used to create a library file and add 
modules. The LIST command is used to display the contents of the library and the 
publics contained within it. 


LIB86<c r> 


iRMX 86 8086 LIBRARIAN Vx.y 


CREATE : PROG : LIBRARY/TRIG . 

ADD :FDO:SIN.OBJ, ::FDO:COS.OBj] TO : PROG ; L I BR AR Y /TR I G . L I B <c r> 
LIST ; PROG : LIBRARY/TRIG .LIB PU^ I C S <c 


:PR0G:L1BRARY/TRIG. LIB 
SIN 
SINE 
COS 

COSINE 


ADD :FD0:SEC.LNK, :FD0;.CSC.LNf, : F DO : COT . LN K , &<cr> 
13: FDO :TAN . LNK TO : P ROG : L I B R AR Y | TR I G . L I B <cr2|l|i|^B 
LIST : PROG : LIBRARY/TRIG . LIB Pui L I C S <c 


:PR0G: LIBRARY/TRIG. LIB 
SIN 

SINE 

COS 

COSINE 

SEC 

SECANT 

CSC 

COSECANT 

COT 

COTANGENT 

TAN 

TANGENT 


EXIT<cr> 
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Example 3: Linking and Locating Programs with Overlays 
Using OVERLAY Control 

The easiest way to build an 8086 program that contains overlays is with LINK86’s 
OVERLAY control. Overlay modules built with this control reside in the same file 
as the root. The operating system supplies routines that will load the overlays con- 
structed in this way. See the iRMX 86 Loader Reference Manual or the Run-Time 
Support Manual for iAPX 86, 88 Applications. 

After the program modules that will constitute the root and its overlays are 
translated, each of the overlays and the root must be linked separately. Then the 
root and all of the overlays are linked together. 

The example following shows the first step toward linking overlays — linking all of 
the modules that will constitute each overlay and the root separately: 


LINK86 0V1.0BJ, 0V1A.0 BJ, 0V1B.[0BJ &<cr> 
□overlay (OVERLAY! )<c 


LINK86 0V2.0BJ, 0V2B.0 BJ, 0V2C,|0BJ 
□OVERLAY(OVERLAY^^ 

HNK8^V?0^^^V3ATB^VERMn0VER^Y3Kc? 


LINK86 0V4.0BJ, 0V4A.0BJ OVERLAY (OVER LAY4Xc r> 


LINK86 ROOT. OBJ, ROOTA.OBJ, R OQTB.OBJ, &<cr> 
□URXSML.LIB OVERLAY (ROOT 


Notice that all of the modules, including the root, are linked with the OVERLAY 
and NOBIND controls. The overlay name for the root is not as critical as for the 
overlays, since the overlay name is used when calling the loader. 

Finally, the overlays and root must be linked together. Since any one of the files 
could be the root, LINK86 requires for the final link the file containing the root 
must be first in the input list. During this final link, the OVERLAY control is not 
used: 


[LINK86 ROOT. LNK, 0V1 . LNK, 0V2. 1 

l.NK, 0V3.LNK, &<cr> 

|aOV4.LNK TO PROG. 86 BIND<cr>* 



In the invocation, the BIND control is specified. The resulting object file is exe- 
cutable on an iRMX 86-based system. 

Figure J-2 shows the LINK86 print file listing for the previous invocation. 

There is nothing special about the invocation line to LOC86 when locating a file that 
contains overlays or that has been bound: 


[L0C86 PROG. 86 RESERVE (OH TO 7' 

|FFH, &<cr>| 

E30FC000H TO OPFFFFHXc 



The RESERVE control prevents LOC86 from assigning memory addresses reserved 
for the Operating System. However, the values you enter with the RESERVE con- 
trol must depend on the size and location of your Operating System and other 
application software. Figure J-3 illustrates the printout from this invocation. 
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IRMX 86 8086 LINKER, Vx.y 

INPUT FILES: ROOT.LNK, OV1.LNK, 0V2.LNK, OV3.LNK, OVN.LNK 
OUTPUT PILE: PROG. 86 

CONTROLS SPECIFIED IN INVOCATION COMMAND: 

BIND 

DATE: MM/DD/YY TIME: 


LINK MAP OF MODULE HOOT 

LOGICAL SEGMENTS INCLUDED: 
LENGTH ADDRESS ALIGN SEGMENT 

3CE7H G CODE 

ODOOH G CONST 

28R0H G DATA 


INPUT MODULES INCLUDED: 
ROOT.LNK(ROOT) 

OV1 .LNK(PARSE) 
0V2.LNK(ILUDE) 
OV3.LNK(PICILUDE) 
OV4,LNK(FASTLOAD) 


GROUP NAME: CGROUP 

OFFSET SEGMENT NAME 
OOOOH CODE\CODE\fiOOT 
3CE6h CODEXCODESPASSI 
3CE8H C0DE\C0DE\PASS2 



SYMBOL TABLE OF MODULE ROOT 


BASE OFFSET TYPE SYMBOL 


OFFSET TYPE SYMBOL 


G(2) 251CH PUB ACTUAL 


ASSUMEROOTCONTRO 


0F22H PUB BASEFIXUPSEXIST 
0D26H PUB BNODEID 
0D28H PUB CLASHNODEID 
OFOOH PUB COMMENTSCONTROL 
0F1AH PUB CURRENTOVERLAYNU 


BINDCONTROL 

BUFEASE 

COCONN 

CURRENTFILNUM 

CURRENTRECINDEX 


OVERLAY NAME = ROOT, MODULE NAME = ROOT 
BASE OFFSET TYPE SYMBOL 


G(2) IIA20H SYM MEMORY 

0(2) ODOOH SYM LASTNMNODEID 

0(2) 0D04H SYM LASTSGNODEID 

G(2) 0D08H SYM LASTIDNODEID 

0(2) ODOCH SYM LASTEXNODEID 

0(2) 0D10H SYM LASTGRNODEID 

G(2) ODINH SYM LASTOVNODEID 

0(2) 0D18H SYM LASTONODEID 


0002H SYM 
0D02H SYM 
0D06H SYM 
ODOAH SYM 
ODOEH SYM 
0D12H SYM 
0D16H SYM 
0D1AH SYM 


COPYRIGHT 

FIRSTNMNODEID 

FIRSTSGNODEID 

FIRSTTDNODEID 

FIRSTEXNODEID 

FIRSTORNODEID 

FIRSTOVNODEID 

FIRSTBNODEID 


OVERLAY NAME = ROOT, MODULE NAME = LIT 


BASE 

OFFSET 

TYPE 

SYMBOL 

BASE 

OFFSET 

TYPE 

SYMBOL 

0(2) 

«A20H 

SYM 

MEMORY 

0(2) 

003CH 

BAS 

SGNODE 

0(2) 

0F56H 

SYM 

LITBASE 

0(2) 

OF58H 

SYM 

LITID 

0(2) 

0F56H 

BAS 

LITNODE 

0(2) 

0F5AH 

SYM 

FIRSTNI 

0(2) 

0F6ltH 

SYM 

FIRSTNODE 

0(2) 

0F8EH 

SYM 

CURREN' 

0(2) 

0F96H 

SYM 

TEMPLATE 

0(2) 

0FB9H 

SYM 

II 

0(1) 

016EH 

SYM 

GETLIT 

STACK 

0006H 

SYM 

INDEX 

STACK 

OOORH 

SYM 

I 

G( 1 ) 

0207H 

SYM 

SGLIT 


Figure J-2. LINK86 Listing for Program with Overlays 
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IRHX 86 8086 LOCATOR, Vx.y 

INPUT PILE: PROG. 66 
OUTPUT PILE: PROG 

CONTROLS SPECIPIEU IN INVOCATION COMMAND: 
RESEhVECOH TO 7 7FFH , OFCOOOH TO OFFFFFH ) 
DATE: MM/DD/YY TIME: 


SYMBOL TABLE OF MODULE ROOT 


BASE 

OFFSET 

TYPE 

SYMBOL 

BASE 

OFFSET 

TYPE 

SYMBOL 

103*tH 

251CH 

PUB 

ACTUAL 

lOSItH 

OFODH 

PUB 

ASSUMEROOTCONTRO 

103‘IH 

0F22H 

PUB 

BASEFIXUPSEXIST 

1031H 

OFOCH 

PUB 

BINDCONTROL 

1 03'tH 

0D26H 

PUB 

BNODEID 

103‘‘H 

2IIEAH 

PUB 

BUFBASE 

1 OSIfH 

0D26H 

PUB 

CLASHNODEID 

lOaltH 

0D5AH 

PUB 

COCONN 

103‘IH 

OFOOH 

PUB 

COMMENTSCONTROL 

103‘IH 

OF50H 

PUB 

CURRENTFILNUM 

1 03‘tH 

OF1AH 

PUB 

CURRENTOVERLAYNU 

103‘IH 

OFBEH 

PUB 

CURRENTRECINDEX 


OVERLAY 

= ROOT 

, MODULE s ROOT 





BASE 

OFFSET 

TYPE 

SYMBOL 

BASE 

OFFSET 

TYPE 

SYMBOL 

103‘IH 

IIA20H 

SYM 

MEMORY 

103‘IH 

0002H 

SYM 

COPYRIGHT 

1 03‘IH 

ODOOH 

SYH 

LASTNMNODEID 

103‘IH 

0D02H 

SYM 

FIRSTNMNOOEID 

103iih 

ODOIIH 

SYM 

LASTSGNODEID 

103‘IH 

0D06H 

SYM 

FIRSTSGNODEID 

103‘IH 

0D06H 

SYM 

LASTTDNODEID 

103‘IH 

ODOAH 

SYM 

FIRSTTDNODEID 

103‘IH 

ODOCH 

SYM 

LASTEXNODEID 

103‘IH 

OOOEH 

SYM 

FIRSTEXNODEID 

103‘IH 

0D10H 

SYH 

LASTGRNODEID 

10:IIH 

0D12H 

SYM 

FIRSTGRNODEID 

103‘IH 

0D14H 

SYH 

LASTOVNODEID 

103. HH 

0D16H 

SYM 

FIRSTOVNODEID 

103‘IH 

0D16H 

SYM 

LASTBNODEID 

103‘IH 

0D1AH 

SYM 

FIRSTBNODEID 

103‘IH 

0D1CH 

SYM 

SGNODEID 

103. IIH 

0D1EH 

SYM 

GRNODEIO 


OVERLAY 

= ROOT 

MODULE = LIT 





BASE 

OFFSET 

TYPE 

SYMBOL 

BASE 

OFFSET 

TYPE 

SYMBOL 

1 034H 

4A20H 

SYM 

MEMORY 

1034H 

003CH 

SYM 

SGNODE 

1 034H 

0F56H 

SYM 

LITBASE 

10:)4H 

0F56H 

SYM 

LITID 

1 034H 

0F56H 

SYM 

LITNODE 

1034H 

0F5AH 

SYM 

FIRSTNODEIDS 

1 034H 

0F64H 

SYM 

FIRSTNODE 

1034H 

OFBEH 

SYM 

CURRENTRECINDEX 

1 034H 

0F96H 

SYM 

TEMPLATE 

1034H 

0FB9H 

SYM 

II 

0760H 

016EH 

SYM 

GETLIT 

STACK 

0006H 

SYM 

INDEX 

STACK 

0004H 

SYM 

I 

0760H 

0207H 

SYM 

SGLIT 


MEMORY 

MAP OF MODULE ROOT 





MODULE 

START ADDRESS PARAGRAPH 

: 14D6H 

OFFSET = 0006m 


SEGMENT 

MAP 






START 

STOP 

LENGTH 

ALIGN 

NAME 

CLASS 

OVERLAY 

07B00H 

0B4E6H 

3CE7H 

M 

CODE 

CODE 

ROOT 

0B4EBH 

0F9BAH 

44D3H 

M 

CODE 

CODE 

PASS1 

0B4EBH 

OEOCEH 

2BE7H 

M 

CODE 

CODE 

PASS2 

0B4E8H 

10337H 

4E50H 

M 

CODE 

CODE 

PIC_PASS2 


ADDRESS GROUP OR SEGMENT NAME 
07800H CGROUP 

CODE\CODE\ROOT 
CODE\CODE\PASS1 
CODE\CODE\PASS2 
C0DE\C0DE\PIC_PASS2 
CODE \ CODEX FASTLOAD 
lOS'lOH DGROUP 

CONSTXCONSTXROOT 

DATAXDATAXROOT 

STACKXSTACKX 


Figure J-3. LOC86 Listing for Program with Overlays 
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Example 4: Linking and Locating Programs with Overlays 
Without OVERLAY Control 

It is harder to produce overlay modules without using the OVERLAY control. 
However, sometimes it is necessary to build programs in this way, for example, 
building a program for running under an operating system that does not support 
overlay modules contained in the same file as the root module. 

But regardless of the reason, building overlays in this fashion places an extra burden 
on the programmer. He must do some of the work that would be left to LINK86 
(and LOC86) if he were to use the OVERLAY control. In the following example we 
prepare a root and two overlay modules in separate files. 

First we must compile all modules. Examples of the invocation lines are shown 
below: 



In the next step we must link the root module to resolve external symbols with a 
library and to obtain a link map: 


LINK86 :F1 :R00T. OBJ, USER. LIB M^P<cr> 


We will need the link map for locating purposes. The link map, shown in figure J-4, 
shows the size of each segment in the root. Since the overlays are self-contained 
except for references to the root, we do not need a link map for them. The PL/M-86 
listing files will show the size of each overlay’s segments, as illustrated in figure J-5. 

Note that the length of the root’s code segment and OVl’s code segment must fit 
within 64K. This means that the code for the overlays must be in a part of memory 
contiguous with the root (to avoid altering the CS register during execution). OV2’s 
CONST and DATA segments are larger than OVl’s so that the STACK segment 
must be placed to leave room for OV2’s CONST and DATA segments. If the 
overlays share the STACK and MEMORY segments with the root, they must be 
located at the same address. 



Figure J-4. LINK86 Map for Root File 
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OVI ‘ s 

segment 

size info rma t i on 


MODULE INFORMATION: 

CODE AREA SIZE = 

7531 H 

30001 0 

this 

i s 

the 

CODE segment 

CONSTANT AREA SIZE = 

0081 H 

1 29 D 

this 

1 s 

the 

CONST segment 

VARIABLE AREA SIZE = 

01 81 H 

385D 

this 

1 s 

the 

DATA segmen t 

MAXIMUM STACK SIZE = 
918 LINES READ 
0 PROGRAM ERROR(S) 

END OF PL/M-86 COMPILATION 

0040H 

64 D 

this 

i s 

the 

STACK segment 



0V2 ' s 

segment 

size in forma t i on 


MODULE INFORMATION 

CODE AREA SIZE 

1 B9AH 

7066D 

this 

i s 

the 

CODE segment 

CONSTANT AREA SIZE = 

0101 H 

2 57D 

this 

i s 

the 

CONST segment 

VARIABLE AREA SIZE = 

0454H 

1 1 08D 

this 

i s 

the 

DATA segmen t 

MAXIMUM STACK SIZE = 
918 LINES READ 
0 PROGRAM ERROR(S) 

END OF PL/M-86 COMPILATION 

0067H 

1 03D 

this 

i s 

the 

STACK segmen t 


Figure J-5. Module Information for Overlays 


After computing the required location for the root’s DGROUP and STACK, we can 
locate the root module. The resulting file will not be executable, but it allows us to 
resolve references to the root’s code and data symbols in the overlays. The following 
LOC86 invocation will leave room for the overlays’ code segments and place the 
DGROUP in the first unused memory location. (In the command line below, the DS 
register is initialized to OFFCEH, and the CS register is initialized to 0.) The STACK 
and MEMORY segments will be located above OV2’s DATA segment: 



Once the root is located, we can use it to resolve external references in the overlay 
modules. The overlay modules cannot call each other, since only one is resident in 
memory at any time. The link commands are shown below. The NOPUBLICS with 
the EXCEPT control is used to avoid conflicts when we use the located overlays to 
resolve external references in the root: 


LINK86 : FI : 0V1 . OBJ , PUBLI CSONLY 

□nopublics excepkovi code, OVI 


j mriiainillSiWJ 


LINK86 :F1:0V2.0BJ,PUBLICS0NLY(:F1 :R00T ) &<cr> 
ESNOPUBLICS EXCEPK0V2C0DE, 0V2[ ATAXc 


The PUBLICSONLY control resolves references to public symbols contained in the 
root. 
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After the overlays have been linked, they must be located. The code and data 
segments must be placed in the memory locations that were reserved when we first 
located the root. In this case the STACK and MEMORY segments must be the same 
for the overlays and the root: 


L0C86 :F1:0V1.LNK 

□ADDRESSES (GR0UPS(CGR0UP (OM) , Dj^ROUP (OF FCEH) ) , 

Q SEGMENTS(CODE(8A9CH,CONST(105EOH) , S TAC K ( 1 0B34H ) ) ) &<cr> 

BOR PER (SEGMENTS (CODE, CONS T, STAPK, MEMORY)) S<c 
Qs E G S I Z E ( S T A C K (1 0 0 H 


L0C86 : F1 :0V2. LNKi 

□AD DR ESSES(GROUPS:(C GROUP ( 0 H) ,DG ROUP (OFFCEH)) , 

□ SEGMENTS(CODE(8A9CHp,CONST(105EOH) , STA C K ( 1 0 B34 H ) ) ) &<cr> 

Border (SEGMENTS (CODE, CONS T, DATjA, STACK, MEMORY) ) 

BSEGSIZE(STACK(100H)Xcr>— 


The CGROUP and DGROUP base address must be specified in order to compute 
offset information. The final base address assigned to DGROUP by LOC86 will be 
rounded down to OFFCOH. 

Once the overlays are located, the root is linked and located into an executable form. 
The PUBLICSONLY control will resolve references to symbols in the overlay 
modules. Other than the addition of this input control, the LINK86 and LOC86 
command must be identical to those used previously: 


LINK86 : F1 :R00T. OBJ , USER. LIB, &<c 
BPUBLICS0NLY(:F1 :0V1 , :F1 :0V2Xcr> 


L0C86 : F1 : ROOT . LNK 

BADDRESSES(GROUPSXGROUP(OM),DGROUP(OFFCEH)), T<cr>]|||^H||^^H 
□ SEGMENTS (CODE (OH) , CONST (OF FCEH) , STACK (1 0B3 4H) ) ) &<cr> 

B0RDER(SEGM:ENTS (CODE, CONS T, DATpi, STACK, MEMORY)) 

BSEGSIZE(STACK(1 OOH) ) <c 


The executable forms of the root and its overlay files are contained in :Fl:ROOT, 
:F1 :OV 1 , and :F1 :OV2. Figure J-6 shows the resulting layout of memory. 



ROOT CODE 
SPACE 



OVERLAY 



CODE 



SPACE 



ROOT DATA 



SPACE 



OVERLAY 



DATA 



SPACE 



STACK AREA 



8A9B 

8A9C 


OFFCO 

OFFCE 


105DF 

105E0 


10B33 

10B34 


10C33 
10C34 ■ 


■DS, SS 


F'igure J-6. Memory Organization for Example 4 
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Invocation Examples 

The following foldout pages contain examples of the iAPX 86,88 Family utility con- 
trols and commands. The examples may be used in conjunction with syntax 
specifications given: 

• In Chapter 2 for LINK86 

• In Chapter 3 for CREF86 

• In Chapter 4 for LIB86 

• In Chapter 5 for LOC86 

When using the directions in these chapters, fold out the page in this appendix con- 
taining examples of the command or control in which you are interested. 

The following is a sample iRMX 86 OH86 invocation: 


I0H86 ; FDO : FINALPROGRAM to : F DOl: F I N I S H . H EX <c r> 
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Comments 


Control 


Examples 


This example defines two public symbols, VARONE 
and VARTWO, with absolute addresses 50H and 
2000H, respectively. 

In this example, the root file is RTFILE, and LIB1 and 
LlB2are library hies. 


ASSIGN 


LINK86 FILE1, FILE2, FILE3 &<cr> 
QASSIGN (VARONE ( 5 0H)_j&<cr>^^B 
□VARTWO (2000) 


ASSUMEROOT 


LINK86 R00T1.0BJ, R00T2.0BJ, &<cr> 
□LIBI, LIB2 TO RTFILE OVERLAY<cr>| 


LINK86 0V11.0BJ, 0V12.0BJ, & <cr> 
□ LIB1, LIB2 TO 0V1.0BJ 8<cr>^H 
□OVERLAY ASSUMER00T(RTFILEXcr^ 


LINK86 0V21.0BJ, 0V22.0BJ, & <cr> 
□ LIB1, LIB2 TO 0V2.0BJ 8<cr>^H 
□OVERLAY ASSUMEROOT(RTFILEXcr^ 


This line creates an LTL module. The output object 
file is ;FD0;TEST with no extension. 

This example specifies default to avoid ambiguity. 


LINK86 RTFILE, 0V1.0 BJ, S<cr> 
□0V2.0BJ TO PROG<cr>^HHH 


BIND/NOBIND 


COMMENTS/NOCOMMENTS 


LINK86 : FDO :TEST. OBJ , &<cr>H 
fliPROG: LIBRARY/ USER. LIB S<cr> 
□bind PRINT<cr>^^^^^^^H 


LINK86: SYS TEM: GENERAL. OBJ &<cr> 
□N 0 B I N D < c r 


LINK86 :F1 iSOUR CE.OBJ &<cr> 
□N 0 C OMM E N T S <c r >■■■■■■ 


Do not use the FASTLOAD control when producing 
code for an iRMX environment. 


LINES is the default, so it need not be specified. 


This MEMPOOL example will increase the minimum 
dynamic memory requirements by 20H bytes, and by 
default the maximum size will increase, if necessary, 
to equal the minimum. 

The minimum dynamic memory requirement is 100H. 
The maximum dynamic memory requirement is 
300H. 




TO :WDO:SYSTEM/TEMP.TST &<cr> 


COMMENTS<cr> 


FASTLOAD/NOFASTLOAD 

INITCODE 

LINES/NOLINES 

MAP/NOMAP 


MEMPOOL 


LINK86 PROG. OBJ, L IB1 , LIB2 &<cr> 
□bind FASTLOAD<cr>HBi^^^^H 


LINK86 :PR0G:MYPR0G INITCODE<cr> 


LINK86 : F1 :TEST/RN.OBJ NOLINES<cr> 


LINK86 : F1 :TEST/RN .OBJ LINES<c.,r> 


LINK86 :F1 :TESTER .OBJ MAP<cr> 


LINK86 : FD1 :MAIN .0BJ7T<c7>^^M 

a :PR0G:USER.0BJ, 

PUBLICSON LY(;FD0:8087. LOO &<cr> 
N 0 M A p < c r > 


LINK86 : FDOiTEST.OBJ , 

□user. LIB, PASCAL. LIB BIND S<cr> 
□MEMPOOL( + 20MXcr>^HHi|H^H 


LINK86 :WDO:USER/TEST.OBJ‘&<cr> 
□MEMPOOLdOOH, +200H) BIND<cr>| 
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Comments 

The L1NK86 output module will have the name 
specified in parentheses in the control. 


This example removes all debug and public records 
from the object file. 


The EXCEPT in the NOPUBLICS overrides the 
PURGE. 


This use of ORDER specifies the order of segments 
for two groups. 


This example will create an overlay record. The 
name of the overlay will be OVERLAY1 . 


First the constituent files must be linked to form 
overlays. 


The print file is ;FD0:USER/TEMP1.MP1. 


The print file is :F1 :PROG.MP1 . 
The print file is ;F1;THE.MAP. 


This example removes information about line 
numbers, local symbols, and comments from the 
print file. 

This statement removes all but the segment informa- 
tion and error messages from the print file. 


iRMX 86 LINK86 EXAMPLES 


Control 


Examples 


^INK86 :USER :T0M. LBJ , &<cr>| 
b/SYS.LIB NAME &<cr>| 

□(THIS IS A VERY LONG MODU LE3NAME . )<c r>l 


OBJECTCONTROLS 


^INK86 : F1 :SRC1 .OBJ , &<cr>| 

D: F1 :SRC2,0BJ , : WDO : USER . LI B &<cr>| 
HnAMECTEST 5.3)<cr>| 

nNK86 :F1:FINAL, &<cr>| 

D:FD1 :USER. lib, SYS. LIB &<cr>| 

□OBJ ECT CONTROLS (PURGE )<cr>| 


ORDER 


OVERLAY/NOOVERLAY 


1K86 :PR0G:PASCL1 .OBJ &<cr J 
OBJECTCONTROLSCPURGE, &<cr>(| 
NOPUBLICS EXCEPTCSTART, &<c7^ 
DATA1, DATA2)Xcr>| 


[L I N K 86 : F 1 : P L M-P R G . 0 B J , & < e r >| 
PLM.LIB, URXSML.LIB, &<cr>| 
USER. LIB ORDERCDGROUP &<cr>| 
(SEG1, SEG2\CLASS1, &<cr>] 

IE G 2 \ CL A SSI \ 0 V ERLAY1), &<cr>J 
CGROUPCCSEGI , CSEG2, &Xr>[ 
CSEG3) )<cr>| 




^INK86 FILE1, FILE2, FILE3 &<cr>| 
□to : FDO :0V1 . LNK &<cr> 
HoVERLAY(OVERLAY 1 )<cr> 


BLINK86 FILE4, FILES, FILE6 &<cr>l 
BDtO :FDO:OV2.LNK &<cr>| 

Dover LAY (OVER LA Y2Xc r>| 

pNK86 FILE?, FILE8, FILE9 &<cr>| 
□to :FDO:ROOT. LNK OVERLAY &<cr>| 
H(R00TXcr>| 


PRINT/NOPRINT 


BLINK86 : FDO:ROOT. LNK, &<cr>| 

Bfl: FD0:0 V1 . LNK, : F DO : 0V2 . LN K<c r>j 

pNK86 : FDOrUSER/PROG.OBJ &<cr>| 
□to : FDO :USER/TEMP1 .TST &<cr>| 
HpRINXc r>| 


PRINT CONTROLS 


6 : F1 :PR0G.0BJ<cr>| 

HLINK86 :PR06:PR0G.0BJ , &<cr>| 
BD:PR0G:USER. LIB PRINT &<cr>| 
B' (:F1 :TH E.MAPXcr>| 

6 :WDO:TEMP.OBJ BIND &<cr^ 

B PRINTC0NTR0LS(N0LINES, &<c r>|l 
NOCOMMENTS, N OS YMBO L S Xc 


pNK86 :WD0:PASCL1 .OBJ &<cr>] 
BpR I NT CONTROLS (PURGE Xc r>| 


J-15/J-16 


iAPX 86,88 Family Utilities 


iRMX86 LINK86 EXAMPLES 


Comments 

Public information concerning only DATA1, DATA2, 
LABELS, and PROC4 is placed in the object file and 
print file. 

All public symbol information will be included in the 
print file and output file. 

This example will produce a file containing only the 
absolute public symbol records from :F1:8087.LOC. 
The object file will be :F1 ;8087.LNK. 

This will resolve the references in ROOT.OBJ to 
absolute public symbols in the separately linked and 
located overlays OV1 and OV2. 

This produces an object file containing no debug or 
public information. 

This confirms that the line and symbol information 
should be kept in the print file. 

This will change the translator-assigned name 
CGROUP to THE@CODE. A subsequent linkage 
would not combine THE@CODE with a group named 
CGROUP. 

This changes the name of the CODE group to 
CGROUP. 

This tells the loader that 15FFH bytes of code is the 
minimum requirement for MEMORY. The new max- 
imum size of MEMORY is 35FFH. 


This increments MEMORY’S minimum size by 1FFH 
(7951 D) bytes. The maximum size of MEMORY is 
equal to the old minimum size plus 3FEH (15902D). 

The local symbol records will be included in the 
object file. 


PURGE is a shorthand for NOSYMBOLS, 
NOCOMMENTS, NOPUBLICS, NOTYPE, and 
NOLINES. 

SYMBOLCOLUMNS has no effect, since BIND was 
not specified. 

The symbol table will be printed on a iine printer. 


LIBMOD will retain its type information. 


Control 


Examples 


PUBLICS/NOPUBLICS 


PUBLICSONLY 


LINK86 : FI :TEST.0BJ , 8<cr>HI^H 
gUSER.LIB NOPUBLICS EXCEPT &<cr>H 
SCDATAI, DATA2, LABEL3, PR0C4Xcr> 


LINK86 : F2:TEMP.0BJ , 

□URXSML.LIB, USER. LIB PUBLICS<cr> 


LINK86 PUBLICSONLY &<cr> 
Q(:F1 :8087. L0CXcr>^H 


[LINK86 : FI :R00T.0BJ , &<cr> 


QPUBLICSONLY ( : FI :0V1 , :F1: 

0V2Xcr>| 


PURGE/NOPURGE 


LINK86 : FI : INDEX .OBJ PURGE<cr> 


LINK86 :WD0: FINAL. OBJ &<cr> 
□PRINTCONTROLS(NOPURGEXcr> 


RENAMEGROUPS 


LINK86 :F1:PLMPRG.O BT" S < cT >1 

g RENAMEGROUPS( CGROUP TO <cr> 
T H E a) C 0 D E X c r > 


LINK86 :WD1 :ASMPRG.06J 
QRENAMEGROUPS (CODE TO CGROUPXcr> 


SEGSIZE 


SYMBOLS/NOSYMBOLS 


SYMBOLCOLUMNS 


TYPE/NOTYPE 


LINK86 : FD1 :GE0RGE.0BJ , &<cr>^ 

8 USER. LIB, SYSTEM. LIB BIND &<cr> 
1 1 I I III mil I 1 1 II WM 

+ 20 00H) Xc 


LINK86 :WFDO:PROJEGT.OBJ , &<cr> 

a :WD0:REST. LIB SEGSIZE &<cr>j* 
(MEMORY ( + 1 F.F ,+1 FF) Xcr>|H^B 


LINK86 : FI :TEMP.0BJ , &<cr>|B 

9 : FI :USER.LI B NOSYMBOLS &<cr > 
SYMB0LS<c 


LINK86 : FDOiTEST.OBJ , &<cr> 

S : F D 1 : S Y S T EM/USER.LIB S<cr> 
PURGE<c 


LINK86 :F1:TEST.0BJ & <c r> 
□SYMBOLCOLUMNS (1 Xcr>||H 


LINK86 : FI :R00T. LNK, 

□: FI :0V1 . LNK, :F1:0V2.LNK, &<cr> 
BpUBLICSONLY ( : WD1 :8087 ) &<crJB 
HsYMBOLCOLUMNS (AUBINDXc^^ 
□PRINT (: LP: 


LINK86 : F1 : LIBMOD. OBJ TYPE<cr> 
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iAPX 86,88 Family Utilities 


Comments 

The cross-reference listing will have 35 lines on each 
page. 

The cross-reference listing will be 100 characters 
wide maximum per page. 


The pathname of the print fiie wiil be :FX1 :MYFILE. 


The message in the TITLE control must be placed on 
one line. If the message contains special characters, 
it must be enclosed in singie quotes (’). 


iRMX 86 CREF86 EXAMPLES 


Control 


Examples 


PAGELENGTH 


PAGEWIDTH 


[CREF86 :F1:FILE1, FILE. LIB &<cj:>J 
BPAGELENGTH(35Xcr>| 

OEFS^^RO^SSa M , &<cr>| 
D:PR0G: LIB(MODI) &<cr>| 
BPAGEWIDTH(100)<cr>| 


PRINT 


ICREF86 : FX1 : FILE$(M0DUL E1 ,M0DULE2) &<cr^ 
□print (:FX1 :MYFILE)<cr>^^^^^^HIH^ 


TITLE 


★ 

* 

* 


MYLIB,HISLIB',HERLIB TITLE & <cr> 
CA CROSS-REFERENCEJ)&<cr>^* 
P A G E W I D T H (1 0 5 )<c 
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iAPX 86,88 Family Utilities 


Comments 

Three object files are added to the USER. LIB. 


Three modules from the library LIB. ABC are added 
to:FDO:PROJ.TOM. 

This command will produce an empty library file 
called TOMS. LIB. 


Four modules are deleted from the library USER. LIB. 


iRMX 86 LIB86 EXAMPLES 


Control 


Examples 


[ADD : F1 :SIN, : FI : COS, : F1 :TAN TO &<cr>| 
B:FQ:USER. LIB<cr>| 

, M0D2, M 0 DT) &< l r>] 

BtO : FDO:PROJ .T0M<cr>| 
OE^^TwDoTsY^MnOMS . LIB<cr>| 


[CREATE ;F0;U$ER. LIB<cr>| 

, &<cr>| 

BTEMP3, TEM_TMP,TEST?Xcr>| 

PE^^^^O^^UbTf^PP^X R T , S<cr>j 
BPAPER TAPE)<cr>| 


LIST USER.LIB<cr> 


USER. LIB 
TEMP 
TEST 
EXEC 
MAIN 
LOOP 


LIST USER. LIB(TEMP,TESTXcr> 


USER. LIB 
TEMP 
TEST 


LIST USER. LIB, TEMP. LIB<cr> 


USER. LIB 
TEMP 
TEST 
EXEC 
MAIN 
LOOP 

TEMP. LIB 
M0DULE1 
MODULES 
MODULETC 
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iAPX 86,88 Family Utilities 


iRMX 86 LOC86 EXAMPLES 


Comments 


Control 


Examples 


If SEG1 is byte alignable, it will be located at 15FFH. 
If SEG2 is byte or word alignabie, it will be at4F5AH. 


Address assignment of groups, segments, and 
classes can be in any order, as long as addresses do 
not conflict with existing absolute addresses. 


A long jump to GO will be placed at location 
OFFFFOH. 


The initialization code is placed at address 32768 
decimal (8000H). 

No initialization code will be produced. 


LINES is the default, so it need not be specified. 


This statement removes all debug records from the 
object file, but keeps the information in the print file. 


NOPUBLICS is implied by PURGE, but PUBLICS 
overrides it. 

SEG@A of CLASS1 will be the first relocatable 
segment located. SEG@B will be next, followed 
immediately by any other segments contained within 
CLASS1. The extra segments in CLASS1 (and all of 
the segments in CLASS2) are located in the order in 
which they are encountered. Finally, the list in the 
SEGMENTS subcontrol is handled. 


ADDRESS 


L0C86 : FD1 : COME . LNK TO WENT 
QADDRESSES(SEGMENTS(SEG1 \CLASS2\ &<cr> 
BoVERLAY 3 (1 5FFH) , S E G 2 ( 4 F 5 A H ) )<c r>BH 


L0C86 :F1:IST.LNK TO LOCIST.RDY &<cr>* 
DADDRESSES (SEGMENTS (SEG1 \CLASS1 &<cr>H 
H(23H)), groups (CGROUP(OOH) /DGROUP &<cr> 
BdOOOOH)) , CLASSES (MEMORY (1 5000H))Xc^> 


BOOTSTRAP 

COMMENTS/NOCOMMENTS 

INITCODE/NOINITCODE 



LINES/NOUNES 


L0C86 :F1:TEST.LNK NOIN ITC0DE<c r> 


L0C86 : FI :TEST. LNK<cr> 


MAP/NOMAP 


L0C86 : FI :TESTER. LNK MAP<cr> 


L0C86 : FDOrGONE. LNK TO &<cr> 






NAME 


L0C86 : F4:SH0RT. LNK NAME &<cr>^ 
□ (THIS IS A VERY LONG : MODULEXc r> 


OBJECTCONTROLS 


L0C86 : F1 :UPWARD. LNK &<cr>BH 
□OBJECTCONTROLS (NOLINES, &<cr> 
□NOCOMMENTS, NOSYMBOLSXc 


L0C86 : F3 : PASCAL1 . LNK 
□OBJECTCONTROLS ( PUR G E , PUB L I C S Xc r> 


ORDER 


L0C86 :F0:SPCSEQ. LNK ORDER 8<cr>HI 
□ (CLASSES (CLASSKSEGJA, SEG3B) , &<cr> 
He LASS2) , SEGMENTS (SEG1 \CLASS3 &<cr>| 
HvOVERLAYI ,SEG22,SEG10\CLAS$5)Xcr>| 
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iAPX 86,88 Family Utilities 


Comments 

The print file is :F1:TEMP1.MP2. 


The print file is :FDD0:INTERRUPT.MP2. 

The print file is :F1:MAP. 

Information about line numbers is removed from the 
print file. 

All but the segment information is removed from the 
print file. 

No public information is included in the output files 
{;USER:PRIVATE.MP2 and :USER:PRIVATE). 

All public information will be included in both the 
print file and output file. 

The object file contains no public or debug informa- 
tion, and the symbol table does not appear in the 
print file. 

The line and symbol information will be kept in the 
print file. 

This control reserves the high-order 64K of memory. 


A 200H and a 100H section of memory at the top and 
bottom of memory are reserved. 

The size of segment MEMORY will be increased by 
2000 bytes. 

The size of segment MYSEG will be decreased by 
511 bytes. 

The new segment size for XENDA is 7770 bytes. 


:FD1 -.AUTO will start at IGNITION. 
•.PROG’.HALTS will start at location 200H. 


This statement will include the local symbol records 
in the object file and the symbol information in the 
print file. 

PURGE is a shorthand for NOSYMBOLS, 
NOCOMMENTS, NOPUBLICS, and NOLINES. 


The symbol table will be printed on a line printer. A 
line printer line can hold a four-column symbol table. 


iRMX 86 LOC86 EXAMPLES 


Control 


Examples 


PRINT/NOPRINT 


PRINTCONTROLS 


PUBLICS/NOPUBLICS 


kOC86 : FI : PROG . LNK TO &<c r>| 

B: F1 :TENIP1 .TST PRINT<cr>| 

:MAPXcr>| 

BPRINTCONTROLSCNOLINESXcr^ 

rOC8^W^DlWsBDIR/PR^K &<cr>| 
BPRINTC0NTR0L$(PURGEXcr>| 

RcS^USE^PRIV^^^Il^rO P UB L iTI < c7>| 


PURGE/NOPURGE 


PC86 :PR0G:TEXT.LNK &<cr^ 
BNOPUBLICS PUBLICS<cr>| 

Rc8^^3?PrW^W^IJ R G E < c r >| 


RESERVE 


SEGSIZE 


START 


SYMBOLS/NOSYMBOLS 


kOC86 :FX0:B0209.LNK PURGE &<cr^ 

& <^>l 

BCOFOOOOH TO OFFFFFHXcr>| 

OCS^^zTHUGO^uTnESE^^ &<cr>] 

B(00H TO 0200H, OFFFOOH TO OFFFFFHXcr>| 

Pc8^w^direc/gSw^^egsiz^<c^ 

flCMEMORY ( + 2000) ) <c r>| 

pOCS^EGPRO^uJ^E G S I Z E &<cr>| 
BCMY$EG(-1 FFH) Xcr>| 

pCS^^RPUC^^K SEGSIZE &<cr>| 
B(XENDA(7770) ) <cr>| 

STARr(IGTlTI0N Xcr>| 

FoC8^PR0^1A^^^r^^^^T<^! 

flCOOH, 200 HXcr>| 

B^CS^ESI^^SiK SYMB0LS<cr>| 


L0C86 :F3:TEST.LNK PURGE<cr^ 


SYMBOLCOLUMNS 


pC86 : F3:DIR2/TEST. LNK &<crH 

□symbol^ 

pCS^USER^NKE^^K &<cr> | 
HSYMBOLCOLUMNS (4) PRINTC : LP:) <cr>| 
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APPENDIX K 
ADDITIONAL INFORMATION 
FOR INTELLEC® SERIES IV USERS 


Environmental Considerations 

The iAPX 86,88 Family utilities run on the Series IV Microcomputer Development 
System. These utilities can be used to produce code for an 8086-based host; the code 
can be executed on the Series IV if the code is load-time locatable (LTL). Resulting 
code is also compatible with DEBUG-86 and DEBUG-88 debuggers (if it is LTL 
code) and with ICE-86 and ICE-88 emulators (if it is absolute code). 

The following conventions of the Series IV operating system (iNDX) are 
encountered when running the utilities; 

• Each of the utilities is invoked by entering the name of the file in which the 
utility resides: 


LINK86 IMYPROG.OBJ , HERPRO.OBJ, HISPRO.OBJ TO QURPR0<cr> 


> 


/SY$TEM;DRIVE/L0C86 /W0RKDRIVE1/PR0G.LNK<cr> 


> 

• The Series IV pathname consists of path components, each preceded by a slash 

(/): 

/SYSA/JOHN/FILE.ABC 

• The directory-name is one or more path components consisting of 1 to 14 
characters, inclusive. One of the directory-name path components may be a 
“logical name.” A logical name must be the first path component in a 
pathname and not preceded by a slash: 

SYSJOHN/FILE.ABC 

• A logical name for some directory may be defined as a null string. Null logical 
names do not appear in the pathname: 

FILE.ABC 

Examples in this appendix employ all these pathname variations. 

• Continuation lines are necessary when a command or invocation will not fit on 
one line. The following example illustrates the line-end conventions to use and 
continuation characters to expect: 


LINK86 M I I'lMlii III! I , yilli'l' I I I I I ' I'AMli'i IN I , i''„ ' i i 

/W0RKFI;LE2/PA:$86/HI$PR0.0BJ , /WORKF I LE3/ F0R86/HERPR0 . OBJ <c r> 


Pathnames may not be split between lines. 

• The LIB86 utility presents an exception to these prompt conventions. Because 
this program is interactive, it has its own prompts: 


LIB86<c r> 


iNDX 8086 LIBRARIAN l/x.y 

■k 

* * 

* 


ADD LIB17PLM/SEC . LNK, L I B 1 / P LM / C S C . LN K , &<c r> 
LIB1 /PLM/TAN . LNK TO L I B 1 / P LM / T R I G . L I B < c r> 
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iAPX 86,88 Family Utilities 


The following versions of the iAPX 86,88 Family utilities may be executed on the 
Series IV : 

LINK86: V2.0 or later 

CREF86: Vl.O or later 
LIB86: V2.0 or later 

LOC86: V2.0 or later 

OH86: Vl.O or later 

Related Publications 

The following manuals may be helpful during various aspects of your work with 
iAPX 86,88 utilities on the Series IV; 

• Intellec Series IV Microcomputer Development System Overview, order number 
121752 

• iAPX 86,88 User’s Manual, order number 210201 

• Intellec Series IV ISIS-IV User’s Guide, order number 1 2 1 880 

• Intellec Series IV Operating and Programming Guide, order number 121753 

• DEBUG-88 User’s Guide, order number 121758 

• PASCAL-86 User’s Guide, order number 121539 

• PL/M-86 User’s Guide, order number 121636 

• ASM86 Language Reference Manual, order number 121703 

• ASM86 Macro Assembler Operator’s Manual, order number 121628 

• 8089 Macro Assembler User’s Guide, order number 9800938 

• FORTRAN-86 User’s Guide, order number 121570 


Program Development Examples 

The following examples are programming problems solved by using one or more of 
the iAPX 86,88 utilities on the Series IV to develop code for an 8086-based host. 

Example 1: Preparing to Use DEBUG-88 

There are only two steps to preparing your code for DEBUG-88 execution: 
translating the code, then linking it with BIND. 

First you must translate your code. Any of the 8086 translators will work. An 
example of one such translation is shown below: 


PLM86 TEST. SRC DEBUG SMALL<cr> 


Once the program has been translated, your must link the program with the BIND 
control. L1NK86 with BIND produces an LTL module. The Series IV assigns 
addresses to LTL modules at load time. The invocation line for LINK86 when link- 
ing the program shown above might appear as follows; 


1LINK86 TEST.OBJ, UT ILS. OBJ, SM/jiLL.LIB &<cr> 
TO BIND<c 
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iAPX 86,88 Family Utilities 


In the above example note that all of the symbol information (LINES, SYMBOLS, 
PUBLICS) is left in the output object file. This will aid you while debugging your 
program. DEBUG-88 uses the symbol information to produce diagnostic information 
on the program. This information is also included in the symbol table. Figure K-1 
shows the print file from the invocation above. 

The libraries specified resolve all of the external references in TEST. OBJ. 

After the above linkage, the program can be executed with the following command 
to the Series IV; 


DEBUG TEST;.86<cr> 



GROUP MAP 


GROUP NAME: CGROUP 

OFFSET SEGMENT NAME 
OOOOH CODE 

GROUP NAME: DGROUP 

OFFSET SEGMENT NAME 
OOOOH CONST 
OOlilH DATA 
01AAH STACK 
05A2H MEMORY 

SYMBOL TABLE OF MODULE ROOT 


BASE 

OFFSET 

TYPE 

SYMBOL 

BASE 

OFFSET 

TYPE 

SYMBOL 

G(2) 

0164H 

PUB 

BINDCONTROL 

G(2) 

004AH 

PUB 

BNODEBASE 

G(2) 

0016H 

PUB 

BUPBASE 

G(2) 

00 1 4H 

PUB 

BUFLEN 

G(2) 

004CH 

PUB 

CLASHNODEBASE 

G(2) 

005EH 

PUB 

COCONN 

G(2) 

01 58H 

PUB 

COMMENTSCONTROL 

C(2) 

016FH 

PUB 

CURRENTOVERLAYNU 

-M 

DEFAULTPRTFILENA 

G(2) 

0171H 

PUB 

DEBUGTOGGLE 

G(2) 

00A5H 

PUB 








-ME 


MODULE 

NAME : 

ROOT 






BASE 

OFFSET 

TYPE 

SYMBOL 

BASE 

OFFSET 

TYPE 

SYMBOL 

G(2) 

05A2H 

SYM 

MEMORY 

G(2) 

OOOOH 

SYM 

COPYRIGHT 

G(2) 

0014H 

SYM 

BUFLEN 

G(2) 

0016H 

SYM 

BUFBASE 

G(1 ) 

OOF7H 

SYM 

ERROR 

GO ) 

OOFEH 

SYM 

WARNING 

G(2) 

0018H 

SYM 

LASTNMNODEP 

G(2) 

001AH 

SYM 

FIRSTNMNODEP 

G(2) 

001CH 

SYM 

LASTSGNODEP 

G(2) 

OOIEH 

SYM 

FIRSTSGNODEP 

G(2) 

0020H 

SYM 

LASTTDNODEP 

G(2) 

0022H 

SYM 

FIRSTTDNODEP 

G(2) 

0024H 

SYM 

LASTEXNODEP 

G(2) 

0026H 

SYM 

FIRSTEXNODEP 

G(2) 

0028H 

SYM 

LASTGRNODEP 

G(2) 

002AH 

SYM 

FIRSTGRNODEP 


Figure K-1 . LINK86 Print File for Bound Object Module 
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0(1 ) 

OOAbH 

LIN 

11(1 

0(1 ) 

00B3H 

LIN 

143 

0(1) 

OOBEh 

LIN 

IbA 

0(1 ) 

00C8H 

LIN 

145 

0(1) 

OOCFH 

LIN 

146 

0(1 ) 

00D2H 

LIN 

148 

0(1 ) 

OODDh 

LIN 

149 

0(1 ) 

00E7H 

LIN 

150 

0(1) 

OOEEH 

LIN 

153 

0(1 ) 

00F5H 

LIN 

153 


REFERENCES TO SEGMENT BASES EXIST IN INPUT MODULES: 
ROOT 


Figure K-1 . LINK86 Print File for Bound Object Module (Cont’d.) 


Example 2: Preparing to Use an ICE System 

Another way to test and debug software is using an in-circuit emulation (ICE) 
system. The ICE-86 or ICE-88 loader can load only absolute object modules. 
Therefore, you cannot use the output from LINK86 immediately; it must be located, 
too. 

The whole process of preparing a program for ICE system execution takes three 
steps. In the first two, the program must be translated and linked: 


PLM86 ICETST.SRC SMALL<cr> 


LINK86 ICETST.OBJ, SMALL. LIB<c 


The above example shows a straightforward linkage with no change to the default 
control setting. Note that NOOVERLAY and NOBIND, the defaults, are set. The 
ICE loader has no facility for dealing with overlay modules created by using the 
LINK86 OVERLAY control. In this case there are no unresolved external references 
in the object module. If the module did contain unresolved references, it could still 
be executed by the ICE: system. However, as with execution under DEBUG-88, 
executing instructions that contain unresolved references will produce undefined 
results. 

Figure K-2 shows the print file produced during the invocation shown above. LINK86 
does not produce a symbol table when NOBIND is in effect. 

Ine last step before ICE system execution is transforming the relocatable object 
module into an absolute object module with LOC86. The invocation line shown 
below would produce an object file that could be loaded and executed by an ICE-86 
or ICE-88 system: 


L0C86 ICETST. LNK<cr> 


This invocation line shows LOC86 invoked with the default control setting. Note 
that the INITCODE control is in effect by default. 
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iKDX a0a6 LINKER, V x.y 

INPUT FILES: ICETST.OBJ, SMALL. LIB 
OUTPUT FILE: ICETST.LNK 

CONTROLS SPECIFIED IN INVOCATION COMMAND: 
DATE: MM/DD/YY TIME: HH:MM:SS 


LINK MAP OF MODULE LOANER 
LOGICAL SEGMENTS INCLUDED: 

LENGTH ADDRESS ALIGN SEGMENT CLASS OVERLAY 


037DH H CODE CODE 

OOOOH W CONST CONST 

0192H W DATA DATA 

03F8H W STACK STACK 

OOOOH W MEMORY MEMORY 

OOOOH G ??SEG 


INPUT MODULES INCLUDED: 
ICETST.OBJ(LOANER) 

SMALL. LIB(DOATTACH) 

SMALL .LIB(DQCLOSE) 

SMALL .LIB(DQCREATE) 
SMALL, LIB(DQDETACH) 

SMALL .LIB(DQEXIT) 

SMALL .LIB (DQGETSYSTEMID) 
SMALL. LIB(DQOPEN) 

SMALL .LIB (DQOVERLAY) 
SMALL. LIB(DQHRITE) 

SMALL .LIB (RYSTEMSTACK) 


Figure K-2 . LINK86 Default Print File 


Example 3: Using CREF86 

Figure K-3 illustrates a CREF86 cross-reference listing for an input list of 15 files, 
one of which contains serveral modules. The output print file pathname 1 /OUTl and 
a title for the listing were specified in the controls. Although PAGEWIDTH (PW) 
and PAGELENGTH (PL) specifications were also noted in the controls, the numbers 
specified are the same as those provided by default. 


EXAMPLE OF CROSS REFERENCE USING CREF86 


INDX CREF86 V x.y 
INPUT FILES: 

OUTPUT FILE: 


1/ROOT. OBJ 1/PARSE. OBJ 1/SIGNON.OBJ 1/STATE. OBJ 
1/SCANNR.OBJ 1/PROCES.OBJ 1/SCUTIL.OBJ 1/LIST. OBJ 
O/COMPAC.LIB 
1 /OUT 1 


1/ERROR. OBJ 1/UTILS. OBJ 
1/LSUTIL.OBJ 1/SORT. OBJ 


1 /MEMMAN .OBJ 
1/UDSMA.LNK 


CONTROLS SPECIFIED: PR(1/0Un) TKEXAMPLE OF CROSS REFERENCE USING CREF86) PW(120) PL(60) 


MODULES INCLUDED: 


FILE NAME 

MODULE NAME(S) 





1 /ROOT. OBJ: 

CREF86 





1 /PARSE. OBJ : 

PARSE 





1/SIGNON.OBJ: 

SIGNON 





1/SIATE .OBJ : 

NEXTSTATE 





1 /ERROR .OBJ : 

ERROR 





1/UTILS. OBJ : 

UTILITIES 





1/MEMMAN.OBJ: 

HEMORYMANAGEMENT 





1/SCANNR.OBJ ; 

SCANMODULES 





1/PROCES,OBJ: 

PROCESSRECORDS 





1/SCUTIL.OBJ: 

SCANUTILITIES 





1/LIST. OBJ: 

LISTOUTPUT 





1/LSUTIL.OBJ: 

LISTUTILITIES 





1/SORT. OBJ: 

SYMBOLSORT 





1/UDSMA.LNK: 

OBJMAN 





O/COMPAC.LIB: 

DQALLOCATE 

DQATTACH 

DQCHANGEEXTENSION 

DQCREATE 

DQDECODEEXCEPTION 


DQDETACH 

DQEXIT 

DOFREE 

DQGETARGUMENT 

DQGETSYSTEMID 


DQGETTIME 

SYSTEMSTACK 

DQOPEN 

DQREAD 

DQSEEK 

DQWRITE 


Figure K-3 . CREF86 Cross-Reference Listing 
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Figure K-3 . CREF86 Cross-Reference Listing (Cont’d . ) 


Example 4: Building and Using Library Files 


A library is a file that contains object modules. Libraries allow you to collect com- 
monly used pieces of software into one file. The library file can be included in a 
LINK86 invocation, and LINK86 will use the modules to resolve references. 


You can add the output from a translator, LINK86, or LOC86 to a library. The 
modules added may be relocatable or absolute; they can have unresolved references 
or be completely linked. 


Let’s consider the following scenario — we have created six routines (SINE, 
COSINE, TANGENT, COSECANT, SECANT, and COTANGENT). We want to 
create a library file that will allow each routine to be linked to programs separately. 


The first step necessary to create the library is to translate each routine separately. If 
we were to output them in a single source module, the translator would translate 
them into one module with six public symbols. We could add this module to a 
library, but when we tried to link one of the routines into a program, all six would be 
included. 
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Once the routines are translated, LIB86 can be used to create a library file and add 
modules. The LIST command is used to display the contents of the library and the 
publics contained within it: 



/WORKDISK/FRED/TRIG . LIB 


SIN 

SINE 

COS 

COSINE 


[A nil Ml I Ml I 'il'Lil I nil, / III IMI I 'll' h 'll Mil, II 
g /WORKDISK/FRED/COT. LNK, / WOR K D I S K / N AN C Y / T AN . LN K , &<cr> 

QtO /WORKDISK/FRED/TRIG. 

[LIST /WORKDISK/FRED/TRIG . LIB P U B L I C S < c r 


/WORKDISK/FRED/TRIG. LIB 
SIN 
SINE 
COS 

COSINE 

SEC 

SECANT 

“cosecant 

COT 

COTANGENT 

TAN 

TANGENT 


EXIT<cr> 


Example 5: Creating Programs with Overlays Using OVERLAY 
Control 


The easiest way to build an 8086 program that contains overlays is with LINK86’s 
OVERLAY control. Overlay modules built with this control reside in the same file 
as the root. The operating system supplies routines that will load the overlays con- 
structed in this way. See the Intellec Series IV Operating and Programming Guide. 


After the program modules that will constitute the root and its overlays are 
translated, each of the overlays and the root must be linked separately. Then the 
root and all the overlays are linked together. 


The example below shows the first step toward linking overlays — linking the root 
and all of the modules that will constitute each overlay separately. 
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lLINK86 0V1^BMVlA^0B^0m^BJ0V^^ 

LINK86 /MYPR0G/0V2A .OBJ , / T H E P 
T00V2ANK0VERLAY(0^ 

nNK8^?RQQ^QB^0^y0B^QQ^^^^MA^^^^VE^m0^^c? 


Notice that all of the modules, including the root, are linked with the OVERLAY 
and NOBIND controls. The overlay name for the root is not as critical as is that for 
the overlays, since the overlay name is used when calling the loader. 

Finally, the overlays and root must be linked together. Since any one of the files 
could be the root, LINK86 requires that for the final link, the file containing the 
root must be first in the input list. During this final linkage, the OVERLAY control 
is not used: 


LINK86 NROOT . LNK, 0V1 . LNK, 0V2 

I.LNK, 0V3.LNK, &<cr> 

0V4.LNK TO 1/PROG. 86 BIND<cr>| 



In this invocation, the optional BIND control is specified. The resulting object file is 
executable on a Series IV. 


Figure K-4 shows the LINK86 print file listing for the above invocation. 

There is nothing special about the invocation line to LOC86 when locating a file that 
contains overlays or that has been bound: 


L0C86 1/PROG. 86 TO PROG & < c 

RESERVE (OH TO 77 F F H , 0 F C 0 0 0 H Tp OFFFFFH)<cr> 


The RESERVE control prevents LOC86 from assigning memory addresses that the 
user wishes to reserve for the target system. Figure K-5 illustrates the printout from 
this invocation. 


INDX bOB6 LINKiSfi, V x.y 

INPUT PILES: NHuOl.LNK, 0V1.LNK, 
OUTPUT FILE: 

CONTROLS SPECIFIED IN INVOCATION 
BIND 

DATE: MM/DD/YY TIME; HH:MM:SS 

LINK MAP OF MODULE ROOT 

OV2.LNK, OV3.LNK, 
COMMAND: 

OVV .LNK 

LOGICAL SEGMENTS INCLUDED: 

LENGTH ADDRESS ALIGN SEGMENT 

CLASS 

OVERLAY 

3CE7H G CODE 

CODE 

ROOT 

ODOOH G CONST 

CONST 

ROOT 


Figure K-4 . LINK86 Listing for Program with Overlays 
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INPUT MODULES INCLUDED: 
ROOT. LNK( ROOT) 

0V1 .LNK(PAflSE) 
OVa.LNKCILUDE) 
0V3.LNK(PICILUDE) 
0V‘(.LNK(FASTL0AD) 


GROUP NAME: CGROUP 

OFFSET SEGMENT NAME 
OOOOH CODE\CODE\ROOT 
3CEOh COOE\CODE\PASS1 


SYMBOL TABLE OF MODULE ROOT 


BASE 

OFFSET 

TYPE 

SYMBOL 

BASE 

OFFSET 

TYPE 

SYMBOL 

G 1 

[2) 

251CH 

PUB 

ACTUAL 

G(2) 

OFODH 

PUB 

ASSUMEROOTCONTRO 

G< 

[2) 

0F22H 

PUB 

BASEFIXUPSEXIST 

G(2) 

OFOCh 

PUB 

BINDCONTHOL 

G\ 

[2) 

0D26H 

PUB 

BNODEID 

G(2) 

24EAH 

PUB 

BUFEASE 

G < 

[2) 

0D2BH 

PUB 

CLASHNODEID 

G(2) 

OD5AH 

PUB 

COCONN 

G ( 

[2) 

OFOOH 

PUB 

COMMENTSCONTROL 

G(2) 

0F50H 

PUB 

CURRENTFILNUM 

G 1 

[2) 

0F1 AH 

PUB 

CURRENTOVERLAYNU 

-M 

G(2) 

OFttEH 

PUB 

CURRENTRECINDEX 



OVERLAY 

NAME = 

ROOT 

, MODULE NAME = ROOT 





BASE 

OFFSET 

TYPE 

SYMBOL 

BASE 

OFFSET 

TYPE 

SYMBOL 

G(2) 

AA20H 

SYM 

MEMORY 

G(2) 

0002H 

SYM 

COPYRIGHT 

G(2) 

ODOOH 

SYM 

LASTNMNODEID 

G(2) 

OD02H 

SYM 

FIRSTNMNODEID 

G(2) 

ODOAH 

SYM 

LASTSGNODEID 

G{2) 

OD06H 

SYM 

FIRSTSGNODEID 

G(2) 

0D08H 

SYM 

LASTIDNODEID 

G{2) 

ODOAH 

SYM 

FIRSTTDNODEID 

G(2) 

ODOCH 

SYM 

LASTEXNODEID 

G(2) 

ODOEH 

SYM 

FIRSTEXNODEID 

G(2) 

0D10H 

SYM 

LASTGRNODEID 

G(2) 

OD12H 

SYM 

FIRSTGRNODEID 

G(2) 

OD14H 

SYM 

LASTOVNODEID 

G(2) 

0D16H 

SYM 

FIRSTOVNODEID 

G(2) 

0D18H 

SYM 

LASTGNODEID 

Gt2) 

OD1 AH 

SYM 

FIRSTBNODEID 



OVERLAY 

NAME = 

ROOT 

MODULE NAME = LIT 





BASE 

OFFSET 

TYPE 

SYMBOL 

BASE 

OFFSET 

TYPE 

SYMBOL 

G(2) 

AA20H 

SYM 

MEMORY 

G(2) 

003CH 

BAS 

SGNODE 

G(2) 

OF56H 

SYM 

LITBASE 

G(2) 

0F58H 

SYM 

LITID 

G(2) 

OF56H 

BAS 

LITNODE 

G(2) 

0F5AH 

SYM 

FIRSTNODEIDS 

G(2) 

OF6AH 

SYM 

FIRSTNODE 

G(2) 

0F8EH 

SYM 

CURRENTRECINDEX 

G(2) 

0F96H 

SYM 

TEMPLATE 

0(2) 

0FB9H 

SYM 

II 

G( 1 ) 

016EH 

SYM 

GETLIT 

STACK 

0006H 

SYM 

INDEX 

STACK 

0004H 

SYM 

I 

0(1 ) 

0207H 

SYM 

SGLIT 


Figure K-4 . LINK86 Listing for Program with Overlays (Cont’d . ) 
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INDX B0B6 LOCATOR, Vx.y 

INPUT FILL: 1/PROG. 66 

OUTPUT FILE: PROG 

CONTROLS SPECIFIED IN INVOCATION COMMAND: 

TO PROG RESERVE(OH TO 77FFH .OFCOOOH TO OFFFFFH) 
DATE: MM/DD/YY TIME: HH:MM:SS 


SYMBOL TABLE OF MODULE HOOT 


BASE 

OFFSET 

TYPE 

SYMBOL 

BASE 

OFFSET 

TYPE 

SYMBOL 

1 OS'tH 

251CH 

PUB 

ACTUAL 

1034H 

OFODH 

PUB 

ASSUMEHOOTCONTRO 

1 0 3*1 H 

0F22H 

PUB 

BASEFIXUPSEXIST 

1034H 

OFOCH 

PUB 

BINDCONTHOL 

1 03‘tH 

0D.26H 

PUB 

BNODEID 

1034H 

24EAH 

PUB 

BUFBASE 

1 03'tH 

0D28H 

PUB 

CLASHNODEID 

1034H 

0D5AH 

PUB 

COCONN 

1 03‘IH 

OFOOH 

PUB 

COMMENTSCONTHOL 

1034H 

0F50H 

PUB 

CURRENTFILNUM 


OVERLAY 

« ROOT 

MODULE = ROOT 





BASE 

OFFSET 

TYPE 

SYMBOL 

BASE 

OFFSET 

TYPE 

SYMBOL 

10311 H 

4A20H 

SYM 

MEMORY 

1034H 

0002H 

SYM 

COPYRIGHT 

1 03HH 

ODOOH 

SYM 

LASTNMNODEID 

1034H 

0D02H 

SYM 

FIRSTNMNODEID 

1 03‘tH 

ODOttH 

SYM 

LASTSGNODEID 

1034H 

0D06H 

SYM 

FIRSTSGNODEID 

103'tH 

0D06H 

SYM 

LASTTDNODEID 

1034H 

ODOAH 

SYM 

FIRSTTDNODEID 

1 03‘tH 

ODOCh 

SYM 

LASTEXNODEID 

1034H 

ODOEH 

SYM 

FIRSTEXNODEID 

1 03‘tH 

0D10H 

SYM 

LASTGHNODEID 

1034H 

0D12H 

SYM 

FIRSTGRNODEID 

1 03‘tH 

0D14H 

SYM 

LASTOVNODEID 

1034H 

OD16H 

SYM 

FIRSTOVNODEID 

103ttH 

0D18H 

SYM 

LASTBNODEID 

1034H 

OD1 AH 

SYM 

FIRSTBNODEID 

1 03‘tH 

0D1CH 

SYM 

SGNODEID 

1034H 

OD1EH 

SYM 

GRNODEID 


OVERLAY 

= ROOT 

MODULE = LIT 





BASE 

OFFSET 

TYPE 

SYMBOL 

BASE 

OFFSET 

TYPE 

SYMBOL 

1 03‘tH 

4A20H 

SYM 

MEMORY 

1034H 

003CH 

SYM 

SGNODE 

1 034H 

0F56H 

SYM 

LITBASE 

1034H 

0F58H 

SYM 

LITID 

1 034H 

0F56H 

SYM 

LITNODE 

1034H 

0F5AH 

SYM 

FIRSTNODEIDS 

1 03‘tH 

0F64H 

SYM 

FIRSTNODE 

1034H 

OF8EH 

SYM 

CURRENTRECINDEX 

1 034H 

0F96H 

SYM 

TEMPLATE 

1034H 

0FB9H 

SYM 

II 

0780H 

016EH 

SYM 

GETLIT 

STACK 

0006H 

SYM 

INDEX 

STACK 

0004H 

SYM 

I 

0760H 

0207H 

SYM 

SGLIT 


MEMORY MAP OF MODULE ROOT 

MODULE START ADDRESS PARAGRAPH s UD6H OFFSET = 0006H 
SEGMENT HAP 


START 

STOP 

LENGTH 

ALIGN 

NAME 

CLASS 

OVERLAY 

07800H 

0B4E6H 

3CE7H 

M 

CODE 

CODE 

ROOT 

0B4E8H 

0F9BAH 

44D3H 

M 

CODE 

CODE 

PASS1 

0B4E8H 

OEOCEH 

2BE7H 

M 

CODE 

CODE 

PASS2 

OB4E8H 

10337H 

4E50H 

M 

CODE 

CODE 

PIC_PASS2 


GROUP MAP 


ADDRESS 

GROUP OR SEGMENT NAME 

07800H 

CGROUP 


CODE\CODE\ROOT 


CODE\CODE\PASS1 


C0DE\C0DE\PASS2 


C0DE\C0DE\PIC_PASS2 


CODE\CODE\FASTLOAD 

10340H 

DGROUP 


CONST\CONST\HOOT 


DATA\DATA\ROOT 


STACK\STACK\ 


Figure K-5 . LOC86 Listing for Program with Overlays 
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Example 6: Linking and Locating Programs with Overlays 
Without OVERLAY Control 

It is harder to produce overlay modules without using the OVERLAY control. 
However, sometimes it is necessary to build programs in this way, for example, for 
running under an operating system that does not support overlay modules contained 
in the same file as the root module. 

But regardless of the reason, building overlays in this fashion places an extra burden 
on the programmer. He must do some of the work that would be left to LINK86 
(and LOC86) if he were to use the OVERLAY control. In the following example we 
prepare a root and two overlay modules in separate files. 

First we must compile all modules. Examples of the invocation lines are shown 
below; 




The next step is to link the root module to resolve external symbols with a library 
and to obtain a link map: 


LINK86 ROOT.OBJ, USER. LIB MAP<:cr> 


We will need the link map for locating purposes. The link map, shown in figure K-6, 
shows the size of each segment in the root. Since the overlays are self-contained except 
for references to the root, we do not need a link map for them. The PL/M-86 listing 
files will show the size of each overlay’s segments, as illustrated in figure K-7. 


INDX b0«6 LINKER, V x.y 

INPUT FILES: ROOT .OBJ .USER .LIB 

OUTPUT FILE: ROOT.LNK 

CONTROLS SPECIFIED IN INVOCATION COMMAND: 
MAP 

DATE: MM/DD/YY TIME: HH:MM:SS 


LINK MAP OF MODULE LOANER 
LOGICAL SEGMENTS INCLUDED: 

LENGTH ADDRESS ALIGN SEGMENT CLASS OVERLAY 


8A<(BH 

W 

CODE 

CODE 

0381H 

w 

CONST 

CONST 

0291H 

w 

DATA 

DATA 

0030H 

- w 

STACK 

STACK 

OOOOH 

h 

MEMORY 

MEMORY 


INPUT MODULES INCLUDED: 

ROOT.OBJ ( ROOT) 

USER.LIB(LOADER) 

USER.LIBCeXIT) 

USER.LIB(ERROR) 

USER.LIB(TIME) 


Figure K-6 . LINK86 Map for Root File 
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MODULE INFORMATION: 

CODE AREA SIZE 
CONSTANT AREA SIZE 
VAR I AB LE AREA SIZE 
MAXIMUM STACK SIZE 
918 LINES READ 
0 PROGRAM ERROR(S) 

END OF PL/M-86 COMPILAT 


OVi ' s se gme nt size 


= 7531H 30001D t 
= 0081 H 1 29D t 
= 0181H 385D t 
= 0040H 64D t 


ON 


7 n fo rma t i on 


his is the CODE segment 
his is the CONST segment 
his is the DATA segment 
his is the STACK segment 


0V2's segment size information 

MODULE INFORMATION 


CODE AREA SIZE 

= 1B9AH 

7066D 

this 

i s 

the 

CODE segment 

CONSTANT AREA SIZE 

= 01 01 H 

257 D 

this 

i s 

the 

CONST segment 

VARIABLE AREA SIZE 

= 0454H 

1 1 08D 

this 

i s 

the 

DATA segmen t 

MAXIMUM STACK SIZE 

= 0067H 

1 03 D 

this 

i s 

the 

STACK segmen t 


918 LINES READ 
0 PROGRAM ERROR(S) 

END OF PL/M-86 COMPILATION 


Figure K-7 . Module Infoimation for Overlays 


Note that the length of the root’s code segment and the larger overlay’s (OV 1 ’s) code 
segment must fit within 64K. This means that the code for the overlays must be in a 
part of memory contiguous with the root (to avoid altering the CS register during 
execution). OV2’s CONST and DATA segments are larger than OVl’s so that the 
STACK segment must be placed to leave room for OV2’s CONST and DATA 
segments. If the overlays share the STACK and MEMORY segments with the root, 
they must be located at the same address. 


After computing the required location for the root’s DGROUP and STACK, we can 
locate the root module. The resulting file will not be executable, but it allows us to 
resolve references to the root’s code and data symbols in the overlays. The following 
LOC86 invocation will leave room for the overlays’ code segments and place the 
DGROUP in the first unused memory location. (In the command line below, the DS 
register is initialized to OFFCH, and the CS register is initialized to 0.) The STACK 
and MEMORY segments will be located above OV2’s DATA segment: 



Once the root is located, we can use it to resolve external references in the overlay 
modules. The overlay modules cannot call each other, since only one is resident in 
memory at any time. The link commands are shown below. The NOPUBLICS with 
the EXCEPT control is used to avoid conflicts when we use the located overlays to 
resolve external references in the root: 


|LINK86 OVI .OBJ , PUBLICSONLY(ROdT) &<cr> 
jNOPUBLICS EXCEPT (OVUODE, 0VlD|ATA)<cr> 


> 

>> 


LINK86 0V2.0BJ ,PUBLICS0NLY(R0 
NOPUBLICS EXCEPT (0V2C0DE, OV: 


The PUBLICSONLY control resolves references to public symbols contained in the 
root. 
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After the overlays have been linked, they must be located. The code and data 
segments must be placed in the memory locations that were reserved when we first 
located the root. In this case the STACK and MEMORY segments must be the same 
for the overlays and the root: 


L0C86 0V1.INK & < c r 

ADDRESSES (GROUPS (CGROUP(OH),D6ROUP(OFFCEH)), 
SEGMENTS(CODE(8A9CH),CONST(10bEOH) , STACK (1 0B34 H) ) ) &<cr> 
QRDER(SEGMENTS(CODE,CQNS T,STApK,MEMOR i I I ii 
SEGSIZE(STACK(100H)) <c 


L0C86 0V2.LNK S; < c r 

ADDRESSES(G ROUPS :(CGROUP(OH),DGROUP(OFFCEH)), 
SEGMENTS(CODE(8A9CH),CONST(105EOH),STACK(10B34H))) &<cr> 
ORDER (SEG ME NTS (CODE, CONS T, DAlh, STACK, MEMORY)) &<c r>— 
SEGS IZE (STACK (1 00 H) 


The CGROUP and DGROUP base address must be specified in order to compute 
offset information. The final base address assigned to DGROUP by LOC86 will be 
rounded up to OFFDOH. 

Once the overlays are located, the root is linked and located into an executable form. 
The PUBLICSONLY control will resolve references to symbols in the overlay 
modules. Other than the addition of this input control, the L1NK86 and LOC86 
command must be identical to those used previously: 


L1NK86 ROOT. OBJ, USER. LIB, 

PUBLICSONLYJOVI^^ 

ADDRESSES (GROUPS (CGROUP (OH) , D G R 0 U P ( 0 F FCEHnTT<cr>H 
SEGMENTS (CODE (OH) , CONST (OFFCEH) , STACK (10B34H))) &<cr> 
ORDER (SEGMENTS (CODE, CONS T, DATA, STACK, MEMORY ) ) S<cr>B 
SEGSIZE(STACK(100H) )<cr>MB||^^^— 


The executable forms of the root and its overlay files are contained in ROOT, OVl, 
and OV2. Figure K-8 shows the resulting layout of memory. 



ROOT CODE 
SPACE 


- 

OVERLAY 

CODE 

SPACE 


- 

ROOT DATA 
SPACE 



OVERLAY 

DATA 

SPACE 



STACK AREA 

' 


8A9B 

8A9C 


OFFCO 

OFFCE 


105DF 

105E0 


10B33 

10B34 


10C33 
10C34 - 


Figure K-8. Memory Organization for Example 6 1216I6-10 
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Example 7: Linking 8089 Programs with 8086 Programs 

The process of linking and locating 8086 programs with 8089 programs that use 8089 
local memory is very similar to creating overlay modules in separate files. 

Let us consider the following example. We have created an 8086 program and two 
8089 program modules. The 8089 programs reference each other’s symbols and 
public symbols in the 8086 program. In addition, one of the 8089 programs must be 
resident in 8089 local memory. 

The first step is to translate the programs. The 8089 program modules must be 
translated separately, since they will be located in different 8089 address spaces. The 
following lines illustrate the invocation lines to the translators: 


^SMS^nOE/ASMAPRO^^ 

ffsM8^^VEmSK^89<c^H 


TASK2 should be linked and located first for 8089 local memory. This linkage will 
leave unresolved external references, but it is needed to resolve the references in 
TASKl: 


1LINK86 /STEVE/TASK2.0BJ , 8089. 

|LIB<cr> 




IL0C86 /STEVE/TASK2 . LNK RESERVE 

K10000H 

TO OFFFFFHXcr>| 


The RESERVE control in the locate above is a precaution to avoid exceeding 64K. 


The next step is to link and locate the object modules that will reside in the 8086’s 
address space. The external references to the 8089 program module that is resident in 
8089 local memory are resolved with the PUBLICSONLY control. The invocation 
lines for linking and locating the modules are: 


LINK86 /J0E/ASM/PR0G86 .OBJ , &<c 
[8086. LIB, /HARRIET/TASK1 .OBJ , 8 
PUBLICSONLY (/STEVE/TASK2) TO 86 



L0C86 86N89. LNK<cr> 


The file 86N89 contains an absolute object module that includes PROG86 and 
TASKl . It may be loaded and executed on an 8086-based system. However, the 8089 
program to be located in 8089 local memory still has some unresolved external 
references. To resolve those references, we must relink with PUBLICSONLY and 
relocate. The invocation lines to LINK86 and LOC86 shown below are identical to 
those used earlier — to guarantee that the references resolved earlier are not 
invalidated: 


LINK86 /$TEVE/TASK2.0B J, 8089.|LIB, 
TU6LICS0Nm86N8^^ 

WcSW^VEmSK^^^ESERVlmHoi^^OFFFFFHKc^ 


NOTE 

The example above makes many assumptions about the 8089 and 8086 code 
that it deals with. In most practical situations it is usually necessary to use a 
more complex LINK86 and LOC86 invocation. However, the example 
above illustrates the key linking and locating principles underlying 
ASM86/ASM89 module combination. 
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Invocation Examples 

The following foldout pages contain examples of the iAPX 86,88 Family utility con- 
trols and commands. The examples illustrate conventions you are likely to encounter 
while using the Series IV, They may be used in conjunction with syntax specifica- 
tions given: 

• In Chapter 2 for LINK86 

• In Chapter 3 for CREF86 

• In Chapter 4 for LIB86 

• In Chapter 5 for LOC86 

When using the directions in these chapters, fold out the page in this appendi?^ con- 
taining examples of the command or control you are interested in. 

The following is a sample Series IV OH86 invocation: 


/SYSTEM/CHARLIE/0H86 /MYCODE/CONE TO /MYCODE/ F IN I . HEX<c r> 
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This example defines two public symbols, VARONE 
and VARTWO, with absolute addresses 50H and 
2000H, respectively. 

In this example, the root file is RTFILE, and 
SYSTEM/LIB1, /SYSTEMB/LIB2, LIB1, and LIB2 are 
library files. 


This line creates an LTL module. The output object 
file is WORK/TEST with no extension. 

This example specifies default to avoid ambiguity. 


LINES is the default, so it need not be specified. 


This MEMPOOL example will increase the minimum 
dynamic memory requirements by 20H bytes, and by 
default the maximum size will increase, if necessary, 
to equal the minimum. 

The minimum dynamic memory requirement is 100H. 
The maximum dynamic memory requirement is 
300H. 


SERIES IV LINK86 EXAMPLES 


Control 


Examples 


ASSUMEROOT 


LINK86 SYS/FILE1, WOR KD I S K/ F I LE2 , &<cr>| 
FTLE3 ASSIGN (VARONE(50H) , &<cr>| 

LINK86 CHARLES/R00T1 .OBJ , &<cr>| 
R00T2.0BJ, SYSTEM/LIB1, &<cr>| 
/SYSTEMB/LIB2 TO RTFILE &<cr>| 

LINK86 0V11 .0BJ,0V12.0BJ,LIB1 , &<cr>| 
LIB2 TO 0V1 .OBJ OVERLAY &<c r>| 
ASSUMEROOT(RTFILEXcr>| 


LINK86 0V21.0.BJ, WOR K/0V22 . OB J , &<cr>l 
SYSTEM/LIB1, /SYSTEMB/ LIB2 T0 'S<cr>Bl 
0V2.0BJ OVERLAY AS SOME ROOT ( RT F I LE XcM 


BIND/NOBIND 


FASTLOAD/NOFASTLOAD 


INITCODE 

LINES/NOLINES 


MAP/NOMAP 


MEMPOOL 


LINK86 RTFILE, 0V1.0BJ, 0V2.0BJ &<cr>| 

SYSTEM/LINK86 WOR K/TEST . OB J , &<cr>| 

LJ-S E-R . L I B B I N D P R l N T 4e 

[sYmM/nNKS^foRK/G^. 0 B N0BI N D<c r>| 

[UNKS^OURC^OB^OCOMM^ 

[uNKS^RO^O^T^^MP^^T^ r > I 

SYSTEM/LINK86 PROG. OBJ, &<cr>| 
USERA/LIB1, LIB2 BIND FAST L0AD<c r>| 

[UNK8^1YDISK/PU1/MmO^N m 

MNK8^u!Tob^?OUNES<c^ 

/SYSTEM/LINK86 WORK/TESTER . OB J &<cr>| 

/SYmM/TlNK86 /WORK/MAIN. OBJ , &<cr>| 
/WORK/USER. OBJ , PUBLICSONLY &<cr>| 

SYSTEM/LINK86 TED/TEST . OBJ , &<cr>| 
USER. LIB, PASCAL. LIB BIND &<cr>| 
MEMPOOL( + 20HXcr>| 


LINK86 TESTED. OBJ MEMPOO L”&<c r>| 
(100H,+200H) BIND<cr>| 
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Comments 

The L1NK86 output module will have the name 
specified in parentheses in the control. 


This example removes all debug and public records 
from the object file. 


The EXCEPT in the NOPUBLICS overrides the 
PURGE. 


This use of ORDER specifies the order of segments 
for two groups. 


This example will create an overlay record, and the 
name of the overlay will be OVERLAY1 . 


I IIOl UIW lOlliU^I M. ill^O illUOl 

overlays. 



The print file is W0RKDISK/TEMP1.MP1. 


The print file is PR0G.MP1. 
The print file is THE. MAP. 


This example removes information about line 
numbers, local symbols, and comments from the 
print file. 

This statement removes all but the segment informa- 
tion and error messages from the print file. 


SERIES IV LINK86 EXAMPLES 


Control 


Examples 


/SYSTEM/LINK86 WOR K/TOM . OB J , S<cr>| 
/SYSTEM/SYSTEM. LIB NAME &<cr>| 

(THIS IS A VERY L0NG3NAME)<c r>| 


OBJECTCONTROLS 


ORDER 


OVERLAY/NOOVERLAY 


LINK86 SRC1.0BJ, SRC2.0BJ, &<cr>| 

LINK86 TOM/FINAL, MARY/USER. LIB, &<cr> 
EVERYONE/SYSTEM. LIB &<cr> 
OBJECTCONTROLS(PURGEXcr> 



LINK86 PASCL1 .OBJ &<cT>| 
OBJECTCONTROLS (PURGE, NOPUBLICS & <cr>| 
EXCEPT(START, DATA1 , DATA2)Xcr>| 

SYmM/UNKS^n^PROG^^^xT^ 
PLM/PLM86. LIB, SM AL L . LIB, S<cr>r ^ 
USER. LIB &<cr>| 

ORDER (DGROUP (S EG 1 , S E G 2 \ C LAS S 1 , &<cr>| 
SEG2\CLASS1 \0VERLAY1) , &<cr>| 

LINK86 FILE1, FILE2, FILE3 TO S<cr> 
0V1.LNK 0VERLAY(0VERLAY1Xcr>| 


LINK86 FILE4, FILES, FILE6 TO &<cr>| 
OV^ 

LINK86 FILE?, FILES, FILE9 T 0-^^4O^ 
ROOT.LNK OVERLAY(ROOTXcr>r 


PRINT/NOPRINT 


W0RKDISK/TEMP1 .TST PRINT<cr>| 


LINK86 PROG.OBJ<cr> 


PRINTCONTROLS 


LINK86 PROG. OBJ, USER. LIB &<cr>| 
PRINT(THE.MAPXcr>r 

SYSTEM/LINK86 MYD I S K/TEMP . OB J &<cr>| 
BIND PRINTCONTROLS (NOLINES , &<cr>| 
NOCOMMENTS, NOS YMBO LS Xc r>| 


LINK86 PAS/PASCL1 .OBJ &<cr>| 
PRINTCONTROLS (PURGEXcr>| 
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Comments 

Public information concerning only DATA1, DATA2, 
LABELS, and PROC4 is placed in the object file and 
print file. 

All public symbol information will be included in both 
the print file and the output file. 


This example will produce a file containing only the 
absolute public symbol records from 8089. LOG. The 
object file will be 8089. LNK. 

This example will resolve the references in 
WORK/PLM/ROOT.OBJ to absolute public symbols 
in the separately linked and located overlays 
WORK/PLM/OVL1 and WORK/PLM/OVL2. 


This example produces an object file containing no 
debug or public information. 

This confirms that the line and symbol information 
should be kept in the print file. 

This will change the translator-assigned name 
CGROUP to THE@CODE. A subsequent linkage 
would not combine THE@CODE with a group named 
CGROUP. 


I nib uiiciiigti^b Lilt; ncuMt; ui uit; t/tyUt 

to CGROUP. 


group 


This tells the loader that 15FFH bytes of code is the 
maximum requirement for MEMORY. The new max- 
imum size of MEMORY is 35FFH. 


This example increments MEMORY’S minimum size 
by 1FFH (7951 D) bytes. The maximum size of 
MEMORY is equal to the old minimum size plus 3FEH 
(15902D). 

The local symbol records will be included in .the 
object file. 

Purge is a shorthand for NOSYMBOLS, NOCOM- 
MENTS, NOPUBLICS, NOTYPE, and NOLINES. 

SYMBOLCOLUMNS has no effect, since BIND was 
not specified. 

The symbol table will be printed on a line printer. 


WORK/LIBMOD.OBJ will retain its type information. 


SERIES IV LINK86 EXAMPLES 


Control 

PUBLICS/NOPUBLICS 


PUBLICSONLY 


Examples 


LINK86 TEST. OBJ, USER. LIB 
NOPUBLICS EXCEPT(DATA1 , 0UA2, 
■ ABEL3, PR0C4Xcr>| 

SYSTEM/LINK86 WORK/TEMP. 03 ’ 
SVSTEM/SMALL. LIB, WORK/USER, L 
PUBLICS<cr>| 

ONK8^U^ICSONLY(8089. lOCF^ 


LINK86 WORK/PLM/ROOT.OBJ, &<. T| 
PUBLICS0NLY(W0RK/PLM/0VL1 , S<: 
W0RK/PLM/0VL2XC r>| 


PURGE/NOPURGE 


is Y S T E M/ L I N K8 6 WQR K / 1 N D El. OBJ 


RENAMEGROUPS 


ILINK86 FINAL. OBJ PR I NTCONTRO L S X c ->j 
KNOPURGEO <c r>1 

LINK86 PLMPRG.OBJ RENAMEGROUPS : r>| 
(CGROUP TO THEaCODE) <c r>| 


SEGSIZE 


[RENAMEGROUPS (CODE TO CG R 0 U P 

SYSTEM/LINK86 WORK/GEORGE . 06^ 
WORK/PETER/USER. LIB, &<cr>| 
SYSTEM/SYSTEM. LIB BIND SEGSIZ 
(MEMORY (1 5FFH,+2000H) )<c r>| 


LINK86 PROJCT.OBJ, &<cr>l 
REST. LIB SEGSIZE(MEMORY &<cr>| 
( + 1 FF, + 1 FF)Xcr>| 


SYMBOLS/NOSYMBOLS 


LINK86 TEMP. OBJ, USER, LIB &<cr^] 
NOSYMBOLS SYMB0LS<cr>| 


SYSTEM/LINK86 US ER /TEST . OB J , a<c->| 
SYSTEM/USER . LIB PURGE<cr>| 


SYMBOLCOLUMNS 


ILINK86 TEST. OBJ SYMBOLCOLUMNS 


TYPE/NOTYPE 


LINK86 ROOT. LNK, 0V1.LNK, &<c^>| 
0V2.LNK, PUBLICSONLY (8089 ) &< 
SYMBOLCOLUMNS (4) BIND PRINT(: L ? . < c r>| 

^Y^M/UNKS^JoS/UBMO^^ 
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SERIES IV CREF86 examples 


Comments 


Control 


Examples 


The cross-reference listing will have 35 lines on each 
page. 


PAGELENGTH 


CREF86 FILE1, FILE . LIB &<cr> 
PAGELENGTH (35)<cr>^^^^H 


The cross-reference listing will be 100 characters 
wide maximum per page. 


PAGEWIDTH 


SYSTEM/CREF86 WORK/PROG, 

SYSTEM/ LIB (MODI) P AG E W I DT H ( 1 0 0 )<c r> 


The pathname of the print file will be MYFILE. 


PRINT 


CREF86 FILES (M0DULE1 , &<cr> 
M0DULE2) PRINT(MYFILEXcr>| 


The message in the TITLE control must be placed on 
one line. If the message contains special characters, 
it must be enclosed in single quotes {’). 


TITLE 
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Comments 

Three object files are added to the USER. LIB. 

Three modules from the library WORK/LIB. ABC are 
added to SYSTEM /PROG. TOM. 

This command will produce an empty library file 
called SYSTEM/TOMS. LIB. 

Four modules are deleted from the library USER. LIB. 


SERIES IV LIB86 EXAMPLES 


Control 


ADD 


Examples 


ADD SIN, COS, TAN TO USER.LIB<cr> 


[ADD WORK/LIB. ABC(M0D1 , M0D2, &<cr>| 
BM0D3) TO SYSTEM/PROG. T0M<cr>| 


CREATE SYSTEM/TOMS. LIB<cr> 


CREATE WORK/USER. LIB<cr> 


[DELETE USER. LIB(TEMP1 , TEMP3, &<cr>] 
BTEMP TMP, TEST?Xcr>| 


Delete w o r k / i o . l i b ( f l o p p y , c r t , ^ < c r >.| 
□paper TAPEXcr>| 


LIST USER.LIB<cr> 


USER. LIB 
TEMP 
TEST 


LIST USER. LIB(TEMP,TESTXcr> 


USER. LIB 
TEMP 
TEST 


LIST USER. LIB, TEMP. LIB<cr> 


USER. LIB 
TEMP 
TEST 
EXEC 
MAIN 
LOOP 

TEMP. LIB 
M0DULE1 
M0DULE3 
MODULETC 
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SERIES IV LOC86 EXAMPLES 


Comments 

If SEG1 is byte alignable, it will be located at 15FFH. If 
SEG2 is byte or word alignable, it will be at 4F5AH. 


Address assignment of groups, segments, and 
classes can be in any order, unless they are 
absolute. 


A long jump to GO will be placed at location 
OFFFFOH. 


The initialization code is placed at address 32768 
decimal (8000H). 

No initialization code '.vill be produced. 


Lines is the default, so It need not be specified. 


This statement removes all debug records from the 
object file, but keeps the information in the print file. 

NOPUBLICS is implied by PURGE, but PUBLICS 
overrides it. 

SEG@A of CLASS1 will be the first relocatable seg- 
ment located. SEG@B will be the next, followed 
immediately by any other segments contained within 
CLASS1. The extra segments in CLASS1 (and all of 
the segments in CLASS2) are located in the order in 
which they are encountered. Finally, the list in the 
SEGMENTS subcontrol is handled. 


Control 

ADDRESSES 


BOOTSTRAP 


Examples 


L0C86 COME.LNK TO WENT 
ADDRESSES(SEGMENTS (SE61\CLASS2\&<cr> 
0VERLAY3(15FFH) , S E G 2 ( 4 F 5 A H ) )<c r>« 


> 

>> 

>> 

>> 

>> 

>> 


L0C86 IST.LNK TO 
ADDRESSES (SEGMEN 
(SEG1 \CLASS1 (23H 
GROUPS (CGROUPCOO 
DGROUPdOOOOH)) . 


SYSTEM/L0C86 WORK/TEST . INK S<cr> 
START(GO) BOOTSTRAP<cr>HHH 


COMMENTS/NOCOMMENTS 

INITCODE/NOINITCODE 


|L0C86 SOURCE-INK N0C0MMENTS<cr>^^^M 

SYSTEM/L0C86 H I S D I S K/ P LM/ FOR K . IN K &<cr> 
I N I T C 0 D E ( 3 2 7 6 8 X c r > 


LINES/NOLINES 

MAP/NOMAP 

NAME 

OBJECTCONTROLS 

ORDER 


^Y^M/^C8^?0RKm^R^nAP<c^B 

Mc8^on^^^^ieBa^v^omap<c? 

(THIS IS A VERY LONG MODU LE0NAME . )<c r> 


L0C86 UPWARD. LNK OBJECTCONTROLS &<cr> 
(NOLINES, NOCOMMENTS, NOS YMBOLSXcr>M 

nC8^ASC^^f^n E^oKo^S<c^ 

(PURGE^PUBLI^^ 

Sc8^PCSEQ^^RDEn<c^H[HH 

(CLASSES(CLASS1(SEG3A, SEGSB), &<cr>| 
CLASS2), SEGMENTS 
(SEG1 \CLASS3\0VERLAY1 , 
$EG22,SEG10\CLASS5)Xcr>M^^^^^B 
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Comments 

The print file is TEMPI .MP2. 

The print file is WORK/INTERP.MP2. 

The print file is MAP. 

Information about line numbers is removed from the 
print file. 

All but the segment information is removed from the 
print file. 

No public information is included in the output files 
(PRIVAT.MP2and PRIVAT). 

All public symbol information m\\ be included in both 
the print file and the output file. 

The object file contains no public or debug informa- 
tion, and the symbol table does not appear in the 
print file. 

The line and symbol information will be kept in the 
print file and object file. 

This control reserves the high order 64K of memory. 

A 200H and a 100H section of memory at the top and 
bottom of memory are reserved. 

The size of segment MEMORY will be increased by 
2000 bytes. 

The size of segment FREUD will be decreased by 511 
bytes. 

The new segment size for XENDA is 7770 bytes. 


AUTO will start at IGNITION. 

HALTS will start at location 200H. 

This statement will include the local symbol records 
in the object file and the symbol information in the 
print file. 

PURGE is a shorthand for NOSYMBOLS, NOCOM- 
MENTS, NOPUBLICS, and NOLINES. 

The symbol table will be printed on a line printer. A 
line printer line can hold a four-column symbol table. 


SERIES IV LOC86 EXAMPLES 


Control 


PRINT/NOPRINT 


PRINTCONTROLS 


PUBLICS/NOPUBLICS 


Examples 


|L0C86 PROG.LNK TO TEMPI. TST PRINT <cr>| 

Sc8^UNEAR^n<c^ 

SYSTEM/HIS/L0C86 PLM/PROG.LNK &<cr>| 
PRINTCON^^ 

pCS^m^^r^OPUBU CS < c r >1 


L0C86 TEXT.LNK NOPUBLICS PUBLICS<cr> 


PURGE/NOPURGE 


Pc86 PR0J5.LNK PURGE<cr> 


RESERVE 


SEGSIZE 


START 


SYMBOLS/NOSYMBOLS 


L0C86 80209. LNK PURGE S<cr^ 
PRINTCONTROLS (NOPURGEX c r>i 

RESERVECOFOOOOH TO OFFFFFH)<cr>| 

msssm 


RESERVECOOH TO 0200H, &<cr>| 

L0C86 GROW.LNK SEGSIZE S<cr>| 

(MEMORY( + 2000)Xcr>| 

PCS^hH^W^E G S I Z E &<cr>| 

|(FREUD(-1 FFH) Xcr>| 

SYSTEM/L0C86 SAL/RP LACE . LNK &<cr>| 
SEGSIZECX^^ 

rSYS/Sc8^EmE/GE^^S^YMBoS< c r > I 


L0C86 TEST. LNK PURGE<cr^ 


SYMBOLCOLUMNS 


L0C86 LINKED. LNK S YMBO LCO LUMN S (4) &<cr>| 
PRINT(:LP:Xcr>| 


K-29/K-30 


INDEX 


absolute object file formats, A-1 
absolute object modules, 1-2 
AD, 5-3 


address, 

in ADDRESSES control, 5-3 
in ASSIGN control, 2-4 
in INITCODE control, 5-6 
in RESERVE control, 5-16 
ADDRESSES, 5-3 
addressing, 

A, 4-2 

absolute, 1-4, 2-4 
ADD, 4-2 
8086, 1-5 
relative, 1-4 
alignment, 
boundaries, 1-8 
of segments, 1-7 
AR, 2-5 


AS, 2-4 


ASSIGN, 2-4 

available memory, effect of, C-1 


BI, 2-6 

BIND, 2-6 

BOOTSTRAP, 5-4 

bound modules {see LTL modules) 

BS, 5-4 


C,4-3 

class, 8086, 1-9 
CLASSES, 5-3, 5-11 
class name, 

in ADDRESSES control, 5-3 
in ORDER control, 

LINK86, 2-15 
LOC86, 5-11 
in SEGSIZE control, 
LINK86, 2-23 
LOC86, 5-17 
CM, 2-7 
COMMENTS, 
inOBJECTCONTROLS, 
LINK86, 2-14 
LOC86, 5-10 
in PRINTCONTROLS, 
LINK86, 2-18 
LOC86, 5-13 
LINK86 control, 2-7 
LOC86 control, 5-5 
control summary, 

CREF86, E-1 
L1B86, F-1 
LINK86, D-1 
LOC86, G-1 
CREATE, 4-3 


CREF86, 

controls, 

PAGELENGTH, 3-3 
PAGEWIDTH, 3-4 
PRINT, 3-5 
TITLE, 3-6 
control summary, 3-2 
error messages, E-1 
in development process, 1-1 
input, 3-1 
invocation, 3-2 

iRMX 86 invocation examples, J-19/J-20 
output, 3-1 
print file, 3-7 

Series III invocation examples, I-23/I-24 
Series IV invocation examples, K-23/K-24 
use of libraries, 1-3 
cross-reference listing, 3-7 
CS, 5-3, 5-11 


D,4-3 

data records, 8086, A-3 
debug records, 
LINK86, 2-21 
LOC86, 5-15 
DELETE, 4-3 


E,4-4 

ENDREC, A-7 
error messages, 

CREF86, E-1 
LIB86, F-1 
LINK86, D-2 
LOC86, G-2 
OH86, H-1 
examples, iRMX 86 
invocation, 

CREF86, J-19/J-20 
LIB86, J-21/J-22 
L1NK86, J-13/J-14 
LOC86, J-23/J-24 
OH86, J-12 
program development 
CREF86, J-3 
L1B86, J-5 
L1NK86, J-6, J-9 
LOC86, J-10 
examples, Series III, 
invocation, 

CREF86, I-23/I-24 
LIB86, 1-25/I-26 
LINK86, I-17/I-18 
LOC86, I-27/I-28 
OH86, I-I5 

program development, 

CREF86, 1-6 
LIB86, 1-7 

LINK86, 1-2, 1-5, 1-8, I-ll, 1-14 
LOC86, 1-4, 1-5, 1-8, 1-12 
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examples, Series IV 
invocation, 

CREF86, K-23/K-24 
LIB86, K-25/K-26 
LINK86, K-17/K-18 
LOC86, K-27/K-28 
OH86, K-15 
program development, 

CREF86, K-5 
LIB86, K-6 

LINK86, K-2, K-4, K-8, K-11, K-12, 
K-14 


L, 4-6 

LHEADR, A-6 
LI, 

LINK86, 2-10 
LOC86, 5-7 
LIB86, 
commands, 
ADD, 4-2 
CREATE, 4-3 
DELETE, 4-4 
EXIT, 4-5 
LIST, 4-6 


LOC86, K-4, K-8, K-12 
EXIT, 4-4 
external references, 
cross-reference listing, 3-7 
definition of, 1-2 
resolution of, 1-3 

FASTLOAD, 2-8 
FL, 2-8 

GR, 5-3 
group, 

addressing, 1-9 
8086, 1-9 
group map, 2-27 
group name, 

in ADDRESSES control, 5-3 
in LINK86 ORDER control, 2-15 
in LINK86 RENAMEGROUP control, 2-22 
GROUPS, 5-3 

hexadecimal-decimal conversion, B-1 
hexadecimal object file format, 
conversion to, 6-1 
records of, 
data. A- 13 
end of file. A- 15 
extended address. A- 12 
start address. A- 14 

IC, 

LINK86, 2-9 
LOC86, 5-6 
INITCODE, 

LINK86, 2-9 
LOC86, 5-6 
initialization code, 

LINK86, 2-9 
LOC86, 5-6 
input list control, 2-20 
iRMX 86 information, 
continuation-line characters, J-2 
environmental conditions, J-1 
examples, J-12 
file-naming conventions, J-2 
generation of code, J-3 
invocation, J-1 
memory requirements, J-1 
program development examples, J-3 
prompts, J-2 
related publications, J-2 


command summary, 4-1, F-1 
error messages, F-1 
in development process, 1-1 
input, 4-1 
invocation, 4-1 

iRMX 86 invocation examples, J-21/J-22 
Series III invocation examples, I-25/I-26 
Series IV invocation examples, K-25/K-26 
librarian (see LIB86) 
libraries, 
adding to, 4-2 
creating, 4-3 
deleting from, 4-4 
listing contents of, 4-6 
use of by CREF86, 1-3 
useofbyLINK86, 1-3 
line number control, 

L1NK86, 2-10 
LOC86, 5-7 
LINES, 

in OBJECTCONTROLS, 

LINK86, 2-14 
LOC86, 5-10 
in PRINTCONTROLS, 

L1NK86, 2-18 
LOC86, 5-13 
LINK86, 2-10 
LOC86, 5-7 
link map, 2-27 
linkage (see LINK86) 

L1NK86, 
and LOC86, 1-4 
controls, 

ASSIGN, 2-4 
ASSUMEROOT, 2-5 
BIND, 2-6 
COMMENTS, 2-7 
FASTLOAD, 2-8 
INITCODE, 2-9 
LINES, 2-10 
MAP, 2-11 
MEMPOOL, 2-12 
NAME, 2-13 
NOBIND, 2-6 
NOCOMMENTS, 2-7 
NOFASTLOAD, 2-8 
NOLINES, 2-10 
NOMAP, 2-11 
NOOVERLAY, 2-16 
NOPRINT, 2-17 
NOPUBLICS, 2-19 
NOPURGE, 2-21 


Index-2 



iAPX 86,88 Family Utilities 


Index 


NOSYMBOLS, 2-24 
NOTYPE, 2-26 
OBJECTCONTROLS, 2-14 
ORDER, 2-15 
OVERLAY, 2-16 
PRINT, 2-17 

PRINTCONTROLS, 5-12 
PUBLICS, 2-19 
PUBLICSONLY, 2-20 
PURGE, 2-21 
RENAMEGROUPS, 2-22 
SEGSIZE, 2-23 
SYMBOLCOLUMNS, 2-25 
SYMBOLS, 2-24 
TYPE, 2-26 

control summary, 2-2, D-1 
erorr messages, D-2 
in development process, 1-1 
input, 1-4, 2-1, 2-20 
invocation, 2-1 

iRMX 86 invocation examples, J-13/J-14 
output, 1-4, 2-1 
print file, 2-27 
segment combination, 1-7 
Series III invocation examples, I-17/I-18 
Series IV invocation examples, K-17/K-18 
use of libraries, 1-3 
LIST. 4-6 

load-time-locatable module (seeLTL module) 
location (see LOC86) 
location algorithm, 
for modules with overlays, 5-25 
for segments, 5-24 

LOC86, 

andLINK86, 1-4 
controls, 

ADDRESSES, 5-3 
BOOTSTRAP, 5-4 
COMMENTS, 5-5 
INITCODE, 5-6 
LINES, 5-7 
MAP, 5-8 
NAME, 5-9 
NOCOMMENTS, 5-5 
NOINITCODE, 5-6 
NOLINES, 5-7 
NOMAP, 5-8 
NOPRINT, 5-12 
NOPUBLICS, 5-14 
NOPURGE, 5-15 
NOSYMBOLS, 5-19 
OBJECTCONTROLS, 5-10 
ORDER, 5-11 
PRINT, 5-12 

PRINTCONTROLS, 5-13 
PUBLICS, 5-14 
PURGE, 5-15 
RESERVE, 5-16 
SEGSIZE, 5-17 
START, 5-18 
SYMBOLS, 5-19 
SYMBOLCOLUMNS, 5-19 
control summary, 5-2, G-1 
error messages, G-2 


in development process, 1-1 
input, 1-4, 5-1 
invocation, 2-1 

iRMX 86 invocation examples, J-23/J-24 
output, 1-4, 5-1 
print file, 5-21 

Series III invocation examples, I-27/I-28 
Series IV invocation examples, K-27 /K-28 
LTL controls, 

BIND, 2-6 
FASTLOAD, 2-8 
MEMPOOL, 2-12 
ORDER, 2-15 
PRINTCONTROLS, 2-18 
SEGSIZE, 2-23 
SYMBOI COLUMNS. 2-25 
LTL modules, 1-2, 1-4, 1-10 


MA, 

LINK86, 2-11 
LOC86, 5-8 
MAP, 

L1NK86, 2-11 
LOC86, 5-8 
maximum-size, 
in MEMPOOL control, 2-12 
in SEGSIZE control, 2-23 
memory, 

configuration with overlays, 1-10 
8086, 1-5 

memory map, 5-23 
memory requirements controls, 
LINK86 MEMPOOL, 2-12 
SEGSIZE, 

LINK86, 2-23 
LOC86, 5-17 
MEMPOOL, 2-12 
minimum-size, 

in MEMPOOL control, 2-12 
in SEGSIZE control, 2-23 
MODEND, A-9 
module attributes, A-2 
module identification, A-2 
module name, 

in L1NK86 NAME control, 2-13 
in LOC86 NAME control, 5-9 
MP, 2-12 


NA, 

LINK86, 2-13 
LOC86, 5-9 
NAME 
LINK86, 2-13 
LOC86, 5-9 

naming output module, 
L1NK86, 2-13 
LOC86, 5-9 
NOBl, 2-6 
NOBIND, 2-6 
NOCM, 2-7 
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NOCOMMENTS, 
in OBJECTCONTROLS, 
LINK86, 2-14 
LOC86, 5-10 
in PRINTCONTROLS, 
L1NK86, 2-18 
LOC86, 5-13 
LINK86, 2-7 
LOC86, 5-5 
NOFASTLOAD, 2-8 
NOFL, 2-8 
NOIC, 5-6 
NOINITCODE, 5-6 
NOLI, 

LINK86, 2-10 
LOC86, 5-7 
NOLINES, 

in OBJECTCONTROLS, 
LINK86, 2-14 
LOC86, 5-10 
in PRINTCONTROLS, 
LINK86,2-18 
LOC86, 5-13 
LINK86, 2-10 
LOC86, 5-7 
NOMA, 

LINK86, 2-11 
LOC86, 5-8 
NOMAP 
LINK86, 2-11 
LOC86, 5-8 
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